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The Amazing Computing Freely Redistributable Software Library- 
announces the addition of... 



New Orleans Commodore Klub's 



inNOCKulation Disk 

Version 1 .5 

To help inform Amiga users of the newer Amiga vimses and provide them with the 
means to detect and eradicate those pesky little critters! 



Files and directories on the 
inNOCKulation Disk include: 



Virus JTexts (dir) 

Various text files from various places 
(Amicus #24^ PeopleLink, and 
elsewhere 1) describing the VJrus(es) and 
people's experiences and tlieir 
recommendations; TVSB 'The Virus 
Strikes Back": satirical text describing 
future efforts to rid the universe of the 
dreaded (silicon) vimses! Interview with 
the alleged SCA virus author! 



WB_Vin4sCheckers (dir) 

VinisXS2 

Runs in the background and checks disks 
for viruses or non-standard boot blocks 
whenever they are insened. (Recognizes 
several viruses and non-standard boot 
blocks. Removes virus in memo^)^ Has a 
built-in "view boot blocks" & other 
features.) 

Senity 

Revision of VirusXl.Ol in Lattice C. 

ViewBoot 

Higiily active mouse-driven disk and 
memory' virus-checker which allows you 
to look at tlie pertinent areas (useful in 
case you suspect a NEW virusl) 



VRrest3.2 

Watches memor>'' for viruses; will alert 
tlie user and allow their removal if 
found. Can check 8i INSTALL disks, etc. 



C£I_VirusCbeckers (dir) 

AVirusII 

From The Software Brewery (W. 
German). Disables a virus in memor>^ 

Clk_Doctor3 

Corrects problems witli [he clock (caused 
by malignant programs, perhaps not 
really a "virus") (A500 & A2000) 

GiiardUinl.l 

Checks for attempts at viral infection at 
boot! Allows you to continue with a 
normal boot (if desired). Includes a small 
utility program to permanently place the 
program on a copy of your Kickstart 
disk. 

KiUVirus 

Removes (any?) virus from memory. 

VinisKiUer 

A grapliically appealing and user friendly 
program by TRISTAR. 



Boot-Block _Stiiff 

SafeBootZ2 

SafeBoot will allow the user to save 
custom boot sectors of all your 
commercial disks and save them for such 
an emergency. If a virus somehow^ 
manages to trash the boot sectors of a 
commercial disk, just rtm SafeBoot and it 
will restore the boot sectors, tlierefore 
saving your disk!! 

Virus_AlertV2.0,2 

Yet another anti-vims program with a 
twist. Once installed on your boot disk a 
message is displayed just after a warm or 
cold boot notifying tlie tlie user tliat the 
disk and memory are vims-free, and 
forcing a mouse-button press before 
continuing. 

BootBackl 

Saves and restoies boot-blocks. Runs 
from CLI only. 

Antivirus akaAVBB 

Includes SEKA assembler source. 

XBoot 

Converts a boot-block into an executable 
file, so you may use your favorite 
debugger (Wack, Dis, ...) to study it. 



The inNOCKulation disk also includes 
icons and arc flies. 



To order the inNOCKulation 
disk, send: $ /:r f^f\ 



includes postage 
& handling 



(S 7. 00 for non-subscribers) 



Amazing^ Computing 

inNOCKulation disk orders 

P.O. Box 869 

Fall River, MA 02722 
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HardEraine/2000 

The SuperSpeed, DMA, SCSI Hard 
Disk Interface for the Ainiga®2000 




How fast is fast? HardFrame/2000 transfers 
data at Amiga bus speeds! It's actually faster 
than the hard disk mechanism itself! And even 

more important in the Amiga's multitasking environment. Hard Frame/ 
2000 has extremely efficient DMA circuitry to get on and off the bus in 
ahiiost no time at all; 280ns to get on; 200ns to get off. And it's true, 
dedicated DMA, too! HardFrame/2000 autoboots ami auto mounts di- 
rectly into the AmigaDOS^'^' 13 Fast File System (old file system parti- 
tions are not needed!). The core of any DMA SCSI interface is in its 
SCSI protocol chip and DMA chip. MicroBotics has chosen the new, 
high performance Adaptec AIC-6250 SCSI chip, capable of up to 5 
megabytes per second raw transfer speed, and the Signetics 6S430 
DMA chip running at 12.5 megahertz. Then we added additional FIFO 
buffering and enabled 16-bit wide data transfers for maximum 
throughput. The sophisticated design of HardFrame/2000 provides for 
automatic SCSI arbitration, selection and reselection. The hardware 
supports either synchronous or asynchronous data transfer. Hard- 
Frame/2000 can function as either the SCSI bus initiator or the target 
and can reside in a multiple master environment. Physically, Hard- 
Frame/2000 is optimally tlexible: the compact, half-size card comes at- 
tached to a full length, plated aluminum frame. The frame has mount- 
ing holes positioned to accept standard, 3.5" SCSI hard disk units such 
as those manufactured by MiniScribe, Seagate, Rod i me, and others 
(hard disk mechanisms must be supplied by the user or his dealer as a 
separate purchase item). Alternatively, you can cable-connect to a SCSI 
drive mounted in your Amiga's disk bay or in an external chassis. As 
many as seven hard disks may be connected to a single Hard Frame/ 
2000. There is no size limit on each disk. HardFramc/2000 includes a 
50-pin SCSI cable and header connectors for either 50-pin or 25-pin 
cable connection. Also included is a current tap to power frame- 
mounted drives directly from the slot itself. HardFrame/2000 comes 
complete with driver, installation, and diagnostic software. 

Available* NOW! Suggested list price, S32^) (hard disk not included) 

Frame loss version: S299,00. See your Amiga Denier. 

The HardFfame/2000 ptioto shows the product with a MmtScribe 
twenty megabyte hard disk installed. Hard disks are no/ included in 
the purchase price of HardFrame. Note that if placed in the first slot, 
HardFrame uses only one slot even wiih a disk attached. 



»AutoBoots AmigaDOS 1.3 
(Price Includes 
HardFrame E^rom!) 

> Directly Boots the 
New Fast-File System! 
(Doesn't Need Old FS!) 

> Auto-mounts All 
Hard Disk Partitions 

(no Mount List Required!) 

> Desi^ned-in^Ultra Strong, 
Multitasking Performance 

> High Quality Metal Frame 
for Stable, On-Card, 
Hard Disk Mounting 

> Power Cabling Directly 
from Card to Disk 

» 50-pin Cable Included 

' Supports up to seven SCSI 
hard disks of any size 



New! 

8-UP! (DIP) FastRAM 

Another great memory board from MicroBot- 
ics, 8-UP! (DIP) is the "brother" of the original 8-UPI 
(which uses SIMMs and PopSIMMs to fill its memo- 
ry space). 8-UP! (DIP) uses conventional 1 megabit 
RAM chips in standard sockets to provide your 
Amiga 2000 with 2, 4, 6, or 8 megabytes of autocon- 
figuring FastRAMI 8-UP! (DIP) is a super efficient 
CMOS design for lowpower consumption and high 
reliability. Suggested list price, $239 (Ok installed) 




MicroBoticSjInc. 

Great Products Since the Amiga Was Born! 

811 Alpha Drive, Suite 335, Richardson, Texas 75081 (214)437-5330 
Tell your deafer he can quick-order from MicroBotics directly - no minimum quantity -show tiim this adf 
"Amiga' is a regislered trademark of Commodore -Amiga. ■HardFrame/2000", "8-UPr. "PopSimm". are trademams of MicroBotics. (nc. 

Circle 109 on Reader Service card. 



Join MicroBotics 

ONLINE TECHNICAL SUPPORT 

CONFERENCE ON BIX 

(The Byte Information Exchange) 

-call 1-800-227-2983 

for BIX membership information! 
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Dear AC: 

Saturday, the 9tli of September, I 
received my new copy of Amazing 
Computing and proceeded to read most of 
it that evening, including "Roomers", in 
which the 'Bandito' malces mention of the 
plan to put the A500 into the mass market 
and suggests SEARS as an outlet, 

Well, today the 11th, we received our 
copy of the Sears 'Wish Book' and while 
penjsing it, before my son glommed onto 
it for good, there on page 6 11 staring me in 
the face is a picture of, guess what, an 
Amiga 500. 

Now, we don't know whom the 
'Bandito' might or might not be, but if I 
believed in magic I might think that he or 
she worked a little hocus-pocus. 

However, after considering all the facts 

I have come to one single conclusion; after 
all it is 'THE WISH BOOK', isn't it. 



Ibis is also a GREAT magazine. 

Sincerely, 
Bob Neer 

-Sometimes we tvonder if the Bandito is 
working a little hocus-pocus. The Bandito is 
always Amazing us and our readers! 
Thanks, we try toproduceagreat magazine 

for the Amiga community, -Ed 



Dear AC: 

As a former IBM employee and MS- 
DOS VAR, I feel that I should add my 
opinion to the debate over Amiga vs. the 
business world. I will concentrate on the 
corporate/Fortune 1000 companies as that 
is my area of experience. It also happens to 
be tlie bread and butter for a lot of large 
computer companies. Let me point out 
some things about their M.I.S. departments: 

1) Since the early 80's, companies have 
invested millions of dollars in (mostly) MS- 




DOS technology. This is not something that 
a company takes lightly and therefore it is 
difficult to switch to anotlier architecture. 
The Macintosh found a couple of raw areas 
but reaUy caught on in large companies 
because of connectivity (e.g., TOPS 
networks). Standardization was a key word 
and tlie Mac gave users more features 
without rendering MS-DOS obsolete. 
Commodore or third parties have yet to 
seriously address connectivity'. 

2) Some large corporations use PC's 
(insulting as it may be) as glorified dumb 
terminals off mainframe or minicomputers. 
Recently, they've begun to try to marry^ the 
respeaive capabilities of tiie machines but 
currently this is only useful for transferring 
data. Commodore and third party 



developers should make some attempts to 
improve on this (but then, so should IBM 
although SAA might help). Amiga 
developers could take advantage of the 
Amiga abilities to provide, for example, a 
327S/79 tenninal that adds a high speed 
graphic front end with completely 
independent multiple host sessions. At tliis 
point any productivity improver for 
mainframes and mini's would have a lot of 
market potential. 

3) Anotlier important stage is compatibility. 
My personal philosophy is that if you're 
going to ignore the standard, you'd damn 
well better be improving on it. The 
operating system is an improvement but 
tiie way common conventions such as (*) 
pattern matching are ignored (for tlie 
simple reason of being different) is 
inexcusable. Some changes such as this are 
defensible considering tlie unique iiinction 
of the OS, but many more are inexcusable. 
This one thing is enough to turn off your 
basic computer barely-literate 
businessperson for whom learning UNIX 
or MS-DOS was a fluke. On the hardware 
side, what about that 23 pin video output 
Why not 1 5 or 25? The benefits of standard 
ports can be appreciated when purchasing 
a printer or external modem. Tr^- finding an 
inexpensive DB-23 connector or gender 
changer. Commodore was not taking 
advantage of the established (read 
inexpensive and available) corner store 
hardware vendors. 

4) My final point is one of the image or 
class. It may seem trivial but how a 
computer is perceived is very important to 
the corporate types. Proof is tlie unu.sually 
high number of relatively slow Macs tliat 
are sold. Here in Canada, the perception 
problem for Commodore is not as acute as 
ilie U.S. In some markets such as 
education, it is still a respected name. It is 
however, significantly influenced by U.S. 
business and computer press. Slicker 
packaging, better customer service, and 
more business journal advertising is 
needed from CBM. A strateg}^ I tliink would 
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You're never 
too old to Scribble! 



Scribble! Platinum Edition 

Scribble! Plalinuni Editian ofTeis many iiiiprovenientij that make Scribble I the word 

prtK-'eShOr of choice for lx.'ginning arid ex|HTit*iut*d users. 

Featuring rapid text t*ntr> aiid stn)lling, Scribble I Pladnum Edition offen* the best of 
all worlds: power, speed, ea^y to use. In no time at all, you'll be writing memos, letters, 
ur ev'en a book! 
SPELLING CHECKER 

Platinum Scribble! shines in this nxm with a 104,000+ woiti dictionary with scientific 
and technical supplements. The Sp(*ll-As-Y()n-1V]H' option ciu*cks spelling on the fly. 
Phi>netie spelling, tnuisposed lettei>>, and cotiinictioiis are no pmblem for Platinum 
Scribble! Knter Kusil and castle is suggested, hie finds ihv and shulhi '/ finds shan't. 
Modify tlie u>er dictionaiy by adding, editing and deleting words with the user dictionary 
niaintentince prognuu. 
THESALTtUS 
Platinum Scribble! has a 470,000^ wonl thesiiurus, with definitions. As a matter of 
fact, the word riffht displays 21 gniups of synonyms. 
MULTIPLE WINDOWS 

Open up to 4 windiMs at once. Display your documents in 2, 4, or 8 color wmdows. 
Change the colore to suit your neetls. Platinum Scribble! supports both interlace and 
non-inierlace screens with horizontal and vertical overscan. 
CUT AND PASTE 
Coj)>, cut and paste text within a single document or from one document to another, 
MAIL MERGE 

Print fonn lettci^^ and mailing lal)els. Enter information at print time or auto- 
matically insim idfoniiation from any mail merge text ille. 
IFF GRAPHIC SUPPORT 
Print IFF gr*ii)hics with iuiy compatible printer supi)orted b>* the Commodore 
Amiga printer drivers. 
CLIPBOARD COMPATIBLE 

Platinum Scribble! is clipl)oard compatible with Micro-Systems Software products. 
OVERVIEW 

• On-scmen bold, ikilk\ and underline , with liighlighting for super and sub-script. • Sup|)ort 
for liLser printer font cartridges • NteLs only ■>l2k of iuemor\' • Not -copy protected • Easy 
hard drive installation • I-Yee Tbchnical Support for Registered Users. 

Committed to iiinileNce since 1978 
12798 Forest Hill Boulevard, Suite 202 
West Palm Beach, Florida 33414 
McraSvstemsSo^iware 407-790-0770 FAX 407-790-1341 

Dealers and Distributors CaU 1-800-327-8724 
See your local dealer for a demonstration. 

Scribble! Platinum Ediiiun is a tmdfmark of Micm-SysU'itis Stjfu-are, Inc. hm^ u a registered irademaik of 
Camnnxlore Business Machines- 

CIrcl* tot on Reodef S»rv(ce card. 




Lons Fonts Vol. 1 

A collection of seven 3D font sets in tlie Interchange 

format. Each set has complete upper/lower case letters, 

punctuation, and numbers! If you're into video or do 

animations, you need these fonts! $29.95 

Momentuin Check 

A full featured checkbook management package that makes 

checkbook management easy. Class codes allow you to 
track any expense you wish. Use standard reports or create 
your own custom reports. Reconciliation is so easy! $29.95 

Momentum Moil 

An easy-to-use mailing list management program. Why 

fiddle with 300-page manuals and spend hundreds of 

dollars when it can be as easy and affordable as this! $29-95 

TeleTutor 

An interactive telecommunications tutorial. Everything 

about telecommunications in one place! Has a simulated 

BBS to practice uploading and downloading. $29.95 

Uzzi Interface 

A joystick/mouse interface with an auto-fire rate of 30 

rounds /sec !! Switch bet^^een auto and transparent mode. 

4 ft. extension cable. Blow your game scores away! $34.93 



Available^: fine dealers, or order (J i reel Make check ot mtincy tjfdcr pav'abic lo 

Micro Momentum, Inc. 

P.O. Box 372 

Washington Depot, CV 06794 

CSOO) 448 7421 



rfep 
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really help is tlie use of specific application- 
oriented VARs for the five or six major 
potential markets. We don't need more 
whiz-bang screen hacks. We need better, 
more professional high end packages in aU 
these markets. Regarding Intuition, the 
Amiga's apparent engineer to engineer 
design approach is noble, but at times a 
disadvantage. Maybe some artists and 
design engineers on CBM's hardware and 
software staff would be beneficial. 

As for the rest of the Amiga community, 
I diink we're taking the wrong attitude 
about our 2000's and 2500's. We know we 
have professional machines so why are we 
always so defensive? The position of tlie 
Amiga community should be one of simple 
pity for owners of the other computers. 
Let's keep producing superior applications 
and cahrdy use them with a smug 
expression on our collective faces. The 
"odiers" will eventually get curious and 
take a good look. 

Sincerely, 

Intkhab Ali 
Desbarats, Ontario, Canada 



-Fottunateiy, CBM's President Ha try 
Coppertyian, has taken steps to alleviate 
some of your concerns. Unlike past CBM 
presidents Mr. Coppennan has followed 
promises with actions. 'Ihis is a welcomed 
change! -Ed 



Dear AC; 

Your magazine is by far the best of die 

Amiga specifics. I subscribe to 3 or 4, and 
have seen several others, so I know. 

I have especially valued die articles on 
programming in AmigaBASIC. I have been 
able to develop a number of almost 
professional looking programs as a result 
of the techniques gathered from the 
ardcies. 

I recendy purchased GFA BASIC 30, as 
a result of favorable review^s; it has a lot of 
features that AmigaBASIC lacks. 

However, just like AmigaBASIC, GFA 
has a considerable learning curve. I have 
had to contact Antic several times already 
to debug programs in their manual, and to 
learn how to access libraries and do menus. 



iMay I suggest that you run a series of 
articles on GFA BASIC, probably for at least 
a year, poiiiting out the unique features of 
GFA. A comparison of commands vs. 
/\miga BASIC would also be helpful. 

If I knew a lot more than I do about this 
good BASIC, I would offer to write die 
article, but unfortunately I cannot do it. 

Sincerely, 

Stuart Casper 

Taylorsville, NC 

'We have heen able to offer our readers 
quaility AmigaBASIC articles because of 
authors like Paul Castonguay, Bfyan 
Cately, Robert D'AstoJohnBushakra, Mark 
Aydellotte, and many more. I'm sure that I 
have forgotten someone, Vjer-e are several 
people working on GFA-BASIC atiicles and 
you should see them soon. -Ed 



Dear AC; 

The article "Fractal Presentation" 
September Issue, was excellent, both 

informative and humorous. The author, 
David Hiestand, writes in a vcty appealing 
and perceptive style. You should offer him 
a job. Good work, Amazing. We need more 
articles like that one. By the way, Dave 
forgot to mention diat another way to 
squeeze more IFF files onto his disk is to 
eliminate all the, info files. 



David Hiestand 
Seattle, WA 

-Could it be possible that there are two 
David Hiestands that both live in Seattle, 
WA? Or could this be the same David 
Hiestand that actually wwte the 'Fractal 
Presentation ' article in AC'S V4S? -Ed 



Do you have a gripe, 

comment, obsei-vation, or 
complaint? 

We want to here from you. 
Send it to: 



A 



mazimAmGA 

L CO Mr ^^n ^,crC7^ 

Letters 

P.O. Box 869 

Fail River, MA 02722-0869 
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review by R. Sbatnms Mortier 



Question: What is a SPRITZ? 

1. The name of a WWI German flying 
ace. 

2. A new Calif omia wine cooler made 
from palm leaves and saki. 

3. A new graphics program from the 
author of the ExpressPaint series. 

Although all of these answers may be 
correct, I'm only going to address tlie tliird, 
which I know is correct. SPRITZ is a new 
Amiga graphics program written by 
Stephen Vermeulen, Readers familiar with 
his ExpressPaint series (especially version 
3.0) should be very comfortable in the 
SPRITZ environment. 

SPRITZ is advertised as a beginner's 
graphics program, sometliing useful to a 
user before moving ''up" to DPaint or (as 
PAR hopes) ExpressPaint. To my mind this 
approach isn't really a wise way to target 
the Amiga market. Professional paint pro- 
grams are generally easy to use, thus re- 
moving a need for preparatory^ software. 

But despite the nature of its promo- 
tional scheme, SPRITZ is more than a 
steppingstone to other graphics programs. 
Let's look at some of tlie positive and 
unique tools that SPRITZ has to offer. , . 

SPRITZ uses the AKP file requester 
standard, developed to make disk access 



easier and faster. There is also an onboard 
point- and-click module that saves the 
ARP. Library to your WorkBench disk, so 
that you don't have to boot witli SPRITZ. 

When you first open SPRITZ, a re- 
quester pops up and waits for you to input 
your screen size. Witli enough memory 
available, SPRITZ can handle the maximum 
number of colors in any Amiga resolution 
except HAM (Personally, I would like to 
see a HAM module included in the fuaire. 
Hnim... a HAM SPRITZ. Sounds like a 
strange drink.) SPRITZ will also handle 
super-bitmapped edit pages and the same 
"virtual page" sizes tliat ExpressPaint 3.0 
addresses. You can maneuver around a 
super-bitmapped screen using SPRlTZ's 
scrolling arrows. 

Like ExpressPaint, SPRITZ has a 
menu bar at tlie bottom of the screen 
which, once accessed, displays specific 
options in a toolbox. If you're not comfort- 
able with diis feature in ExpressPaint — or 
feel visually constrained by its placement- — 
then don't expect SPRITZ to cakii your 
nerves. If, however, you appreciate (as I 
do) the ways in which this hierarchical 



Left: the main dmwmg screen. 
Right: Sp?itz's simplified palette requester. 



arrangement can be manipulated, then 
SPRITZ will provide a comlbrtable inter- 
face for you. 

If you're interested in getting a run- 
down of the normal graphic tools and their 
arrangements, look up a review of any 
version of ExpressPaint. The only differ- 
ence is diat SPRITZ doesn't have some of 
the fancier EFX brush and printing capabili- 
ties, rll note diese specifics as we go along. 

After you select die resolution and 
number of colors you desire, SPRITZ ap- 
pears in a flash of lighming. Across the top 
of the screen you'll see the current color 
palette. This can be altered either internally 
or by importing an IFF graphics screen, 

SPRITZ resides in memory in a non- 
threatening fashion, so, provided you have 
some expansion RAM. you shouldn't have 
any Q-ouble multitasking. Which brings me 
to another point: SPRITZ can be "iconized/' 
meaning that it can be set to sleep mode. 
When this is done, die only reminder to you 
that it is still in the system is a small SPRITZ 
menu bar sitting on your WorkBench 
screen. (When dozing, SPRITZ takes even 
less memory^) You can "wake it up" with a 
few simple clicks of die mouse. This feature 
is a great multitasking tool that is just 
starting to used widely in the Amiga envi- 
ronment. 
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SPRITZ allows you to access any 

alternate font disks you miglit have, and 
also has the capacity to address the Amiga 
ColorFont standard. Its text Rmction is a bit 
awkw^ard, in that you can't type large 
amounts of text to the screen at one time 
(80 characters is the maximum). Instead, 
you must go through a bit-by-bit placement 
procedure. It must be remembered, ho^*- 
ever, that SPRITZ is not advenised as a 
desktop publishing program. It has none of 
the text- pouring operations that Ex- 
pressPaint boasts. 

Several kinds of files may be ac- 
cessed with SPRITZ; "cuts" (brushes), pic- 
tures, and icons. Like ExpressPaint, SPRITZ 
allows you to load many cuts into the 
system at once, t:)uc make sure they all use 
the same palette. Pictures are standard IFF 
file images in non-HAM 

As far as icon-editing is concerned, 
SPRITZ can load, edit, and save Work- 
Bench icons. These can be attached to files 
with the Sit utility provided. SPRITZ allows 
you to design and implement all diree types 
of Amiga icons: Complement Highlighted 
(icon changes color when clicked), Back- 
filled Complemented (icon changes color 
without tlie rectangular outline), and Alter- 
nate Imaged (the icon image changes to an 
altogether different image). Wouldn't it be 
nice to include animated icon constmc- 
tion — witli some technique like the DPaint 
III animation baishes™ in a future up- 
grade? 

The tide bar can be toggled off for 
video use, but unlike in other programs, 
this doesn't allow you to access the menus 
at die top. This restriction may take a few 
minutes to get used to. The menu bars and 
the mouse pointer can also be toggled. 

Another convention in both SPRITZ 
and ExpressPaint is the use of the right 
mouse button in the "live" drawing area. 
When depressed, the right mouse button 
mms on a zoom pointer in the lower right- 
hand comer of the screen. This pointer tells 
you the X- and Y-coordinates of the 
mouse's position. 

ExpressPaint was the first Amiga 
graphics tool to incorporate multiple 
UNDOs, and SPRITZ follows in its foot- 
steps. This function is closely wed to your 
CHIP and FAST RAiM availability. It allows 
you to back up through your work, revers- 
ing any drawing procedures that you may 
have enacted. When the function is aai- 
vated, it is vAsq to flush the system clean 
now and again to free needed memorj^. 
When you don't need it, you can simply 
turn it off. 

Both SPRITZ and the latest release of 
ExpressPaint also include a convention 



called SmartLink. This allows you to port 
cuts and palettes from one program to 
another within a true multitasking environ- 
ment. Both the Client and the Most must 
support SmartLink in order for it to work. 
PAR wishes that more ^Vmiga packages 
would support tliis convention, and so do 
I. Imagine being able to develop a brush in 
one Amiga program and then port it into 
another multitasking environment. Amiga 
users should get together and petition 
other developers to incorporate this stan- 
dard (which PAR offers to interested parties 
at no cost). 

My favorite SPRITZ Rmction— 
whicli, to me, makes the program worth 
every penny — is Grab Screen. As a re- 
viewer of Amiga articles, I often find tny.self 
needing to grab and save screens that 
include pull-down menus. When you acti- 
vate tlie Grab Screen function in SPRITZ. 
you have ten seconds to take a snapshot of 
the screen you want by clicking the front- 
back gadgets in the upper right-hand cor- 
ner. Once you're where you want to be, the 
screen flashes tuice and... Voila! You're 
back in SPRITZ looking at a perfect grab of 
the screen you selected. Tlie only change 
rd like to see in Grab Screen is the addition 
of a variable time element. At times it can 
be very difficult to get where you want to 
go in ten seconds. 

Like ExpressPaint. SPRITZ handles 
cuts (baishes) in a novel fashion, allowing 
you to create effects that few other paint 
programs can handle. For example, the 
program allows you to make Power Bor- 
ders. By taking any brush and using it to fill 
in a 9- or 1 2-part grid, you can automati- 
cally render beautiful certificate borders in 
a flash. The process is a snap, and several 
samples are included to get you started. 

Should you require technical sup- 
port, an address and telephone number are 
listed here. Also included are an address 
and telephone number for those interested 
in submitting programming utilities and 
clip art to Glacier Teclinoiogies 

In my opinion, SPRITZ shouldn't be 
advertised as a paint program at all, but 
instead as version 1 of a new Amiga graph- 
ics utilit)^ (Knowing the prolific manner in 
which Mr. Vermeulen upgrades his crea- 
tions, I expect that tlie next upgrade is 
already in the works— if not finished.) Even 
though it does appear at first glance to be 
a minor version of ExpressPaint, SPRITZ 
does many things that no other program 
can do. To use it is to love it. I am sure tliat 
it will find a home in your Amiga graphics 
library. 



ICON MAGIC 

If SPRITZ is the child of ExpressPaint, 
then ICON MAGIC is the child of SPRITZ. 
ICON MAGIC builds upon tlie icon-ma- 
nipulating module in SPRITZ, ju.st as 
SPRITZ builds upon the tools of Ex- 
pressPaint. With ICON MAGIC, you can 
load and edit any Amiga icon type before 
saving it again. Palettes can be changed, 
renderings flipped, and new attributes 
drawn. Using all of tliese capabilities, you 
can take all of those standard and boring 
icons and do something creative widi them. 
Having new icons on your personal disks 
can allow for much easier and quicker 
recognition of tlieir contents. 

As in SPRITZ, IFF images can be 
translated into icons, and vice versa. Also 
important is tliat ICON MAGIC is the third 
piece of sofru^are to include the SmartLink 
convention, allowing all diree packages to 
multitask with each other. Thus, all of the 
tools in ExpressPaint 3-0 can be used to 
create truly unique icons. Without ques- 
tion, ICON MAGIC is the necessary third 
part of the tremendous Vermeulen triumvi- 
rate of Amiga graphic tools. 

•AC- 



Morkefedby: 

Prof essionaf Automation 

Resources 

P,0, Box 1089 

Var)couver WA 98666 

(206)694-1539 

SPRITZ. $79.95 
Inquiry i^ 218 

ICON MAGIC 
Inquiry tf 219 



AO GUmE^MiGA 

ACS GUIDE 
to the COMMODORE AMIGA 



Hardware? 

Software? 

Otlierware? 

If it's available for the Amiga 

It's in AC s GUIDE 

Over 2200 Products from almost 

500 Vendors 

On Sale NOW 
at your local Amazing Dealerl 
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flPL and the flMIGfl, 

^Qrt III nocij to k/f^it& a PM^f^-m 



by Henry T, Lipper% EdD, 

Last time, a quick introduction to the computer language, 
APL, was examined. At that time, a promise was also made to look 
at how to write a program. Keeping true to the promise, diis article 
will discuss program writting in APL. 

Wlien a statement Ls entered into APL, it is executed imme- 
diately, as shown in die last article. The APL user types each 
statement and ends it with the RETURN key. When die RETURN 
character is detected, tlie statement is interpreted into machine 
code and executed. There is a character that tells AI^L to stop tliis 
immediate execution mode. It is an upside-down delta, (V) known 
as "del". The presence of the del at the beginning of a line is inter- 
preted to meanr "do not execute any statements until another del 
is detected." Statements are collected, instead of executed. A 
program is eitlier being written, or edited, and in eitlier case, die 
statements are to be collected until die next del is entered. The 
second del ends the collection mode and returns to the immediate 
execudon mode. If die work "average" is typed: 



V AVERAGE 



El] 



APL responds as shown. ^VPL makes the determination: "Don't 
execute this statement; a program is being edited or written." If 
there is an object in the active workspace with the name A\^RAGE, 
then it will be opened for editing (more on editing later). If there 
is no such object, a new program is being written. A bracketed 
number becomes a numbered staiement in the program diat will be 
named "AVERAGE." APL continues, "What is statement number 1?" 
If the statement which computes the arithmetic average that 
was developed in the last installment is used, it would appear as 
follows: 



[1] 



^AVERAGE 
i + lDATA) ^ pDATA^ 



and is a complete program written in APL. The entire program 
would be read: "stop immediate execution, edit if it exists or define 
a program named A\niRAGE." Continuing, Line 1 would be read: 
"Sum reduce the numbers stored at DATA, divide by how many 
numbers are stored at DATA, end of program, retum to immediate 
execution mode." Note that the two lines were simply collected as 
a program and were not executed, i.e., no average was computed, 
at that time. To use this program, there must be some numbers 
stored at the variable DATA. All it takes to establish a variable and 
to set up a set of numbers stored at that variable name is to give to 
APL a statement such as the following: 

DATA <— 2 4 5 7 6 3 12 




which would be read "data is specified by 2 4 5 7 5 S 12." To call 
the program, type the name of the program as follows: 

AVERAGE 
16.142857143 

and APL replies widi die answer. 

The program AVERAGE was written using the variable name 
DATA in the body of the program. By using this technique, the 
program always refers to die same storage area, "DATA." By 
entering a new set of numbers into DATA, the program can be used 
repeatedly. It may not be convenient to always have the numbers 
stored at DATA. 

Because of the extensive and powerful capabilities of AJ^L, 
any such restrictions (saying diat "it may not be convenient") is a 
"tip-off that there is probably a better, more general, and more 
elegant way of writing the program. Indeed there is. If the program 
is rewritten, it will be more useful without such a restriction. If the 
program was typed as follows: 

V AVERAGE X 
[1] {+/X) -i- px V 

a more general program results. The change in line zero (the header 
of die program) was a space followed by "X". The variable X 
becomes a local variable which means it exists only inside the 
program during the call to AVERAGE. By diis different header, the 
APL interpreter was told tliat data is intended to be supplied each 
time the program is called. For example, to use this revised program 
to compute the mean of a set of numbers, r^pe: 

AVERAGE 26479 10 12 18 
6.55555555S 

and APL performs the calculations using the values diat are placed 
at the temporary' storage space "X" inside the program. The X in the 
header took on the values listed as an "argument" when tlie 
program was called. 

As might be suspected, the numbers stored at DATA can also 
be used: 

AVERAGE DATA 
16.142857143 

dius giving the same result as before. By storing other numbers at 
different storage names: 

NUMBERS ^S6 456 2345 3468 233 7648 3345 
GIRLS <~ 345 532 667 546 645 578 
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our averaging program can be used as follows: 



AVEBAGE NUMBERS 
2507.285714 



AVERAGE GIRIS 
552,166 6 6 67 



thus showing the use of the various named storage areas as right 
arguments when the program is called. 

The use of tlie argument requiring local variable "X", in tlie 
header of the program, has made the program AVERAGE more 
useful and more general. What about tliat word "argument" used 
above? These arguments are familiar, but the term is thought of very 
often since the use of arguments is so automatic- If said in "math": 

82 + 43 

One of the "primitive" operations in mathematics has been used, 
i.e., plus, C+") with two arguments, 82 as a left argument and 43 
as a right argument. The program AVERAGE used only a right 
argument and triggers dioughts of another notation in matliematics: 

TAN {K} 

or, tangent of X, meaning: take the tangent value of the number 
(argument) of the value represented by X. 

APL also allows for tlie use of two arguments. For example, 
a program tliat simulates the action of the plus primitive operation 
in mathematics can be written. The header of the program in APL 
might be: 



V X PLUS y 



fi) 



with APL's usual request for line 1, which is typed: 
[1] X + y V 

thus using an APL program lo act similar to the + primitive operation 
in mathematics. Using the new program: 



8 PLUS 4 



12 



it appears that a substitute for the '*+" sign has been discovered. If 
it is a true substitute for traditional math notation for "+" the 
following statement: 



2 + 8 PWS 4 



should work. One of the advantages of APL is how easy it is to try 
an expression to see if it works. The APL as well as the mathematics 
can be checked out: 



2+8 PLUS 4 
12 
VALUE ERROR 

2+8 PLUS 4 



is the result. APL said to itself "what was asked for, was done, 8 and 
4 were submitted as arguments to the program PLUS, the result was 



12 which was displayed (since no other use for die result was 
indicated in line [1] of the program), the next operation no^' 
appeared for evaluation: 



2 + 



and there was no right argument for the "+" operation." Since there 
was no value for the right argument, a VALUE ERROR message was 
given. The carat appeared on tlie line below to indicate where APL 
found the error. 

Obviously, tlie program must be modified to make it possible 
to adequately substitute for a "real" matliematical function. APL has 
a nifty way of handling this requirement. This change is accom- 
plished by a different format of the program header. By setting the 
program up to produce an "explicit result," the "+" mathematical 
operation is more fully simulated. \Xliile editing will be covered 
later when tiie impienicntation of AI^L on tlie AMIGA is the topic 
of discussion, a system command: 

) ERASE PLUS 

gets rid of the old program so it can be replaced. The revised 
program: 



V R^ 

[1] H ^ X 



X PLUS 
' Y V 



uses a different header (line 0) which indicates that the program 
produces an explicit result when it is finished. Line 1 specifies the 
result within the program, tlius making it available so that now the 
previous statement: 



2+8 PLUS 4 



14 



no longer has the problem of a \^alue error as before. The explicit 
result (12) from the program PLUS is now left for the next 
evaluation; 



2 + 12 



14 



which yields the answer 14. 

In APL, programs are spoken of as being "functions." Now it 
is easy to appreciate why. The Al^L approach uses the madicmatical 
idea of the function in the same way as the mathematicians have 
always expressed the matliematical operation between arguments. 
The extraordinary^ simplicity and power of this abilit)' to write a 
function and have il be consistent and compatible widi ordinary 
mathematics is one of the secrets of the efficiencies of AJ^L as a 
productive language. Functions in APL are modular by their very 
nature and lend diemselves to die more recent notion of "struciured 
programming/' It is simple to write an APL function, tiy it on all 
kinds of arguments to test how generalizable it iSj then use it as a 
building block in more complex structures. 

Try the program on a vector of numbers; 

12 3 PLUS 6 7 8 
7 9 11 

Well, that worked. Try another to see if tlie user defined function 
will make a difference in the following: 
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:800-558-0003: 



iBOO-558-0003: 



IVS Trumpcard Hard Drive I Trumpcard 500 Hard Drive ■ XETEC FOSt Card 
Packages for A2000 Series | Packages for Amiga 500 | Ha^oriy.f^ag^tcAn^20oo 



Seagate 

ST-157N 4B ME9 519 DEL 

ST- 1 77N 60 M E€ „„ „.._ .„, „.^„74e DEL 

8T*e77N-1 60 ME«.„.„- „^ fllfl Da 

rr.296N BO ME€ .-.„._. „. 92^ DEL 

Quantum Pro Drive 

40MEGSCSJProDrtvo.. 6 IP DEL 

60MEGSCSJ Pro Ortve ...„,. SifiDR 
100 MBS SCSI Pro Of N« 9^|?a 

th**e Ht3 InckKte IV8 Tninpcafd SCSI hafd driw ctrt 
cabk>. software J nd FREE dflllmry In the contiguns 
U3A Thli h nol anafspmb^y Idt I iMi ^ p^ctcsgc, 



Hard Drive Canis {A-2000) 



Seagate 

eT-157N 45 MEG „.......,„. 539 DEI 

ST-177N 6OME0 „ 769 DEL 

Quantum Pro Drive 



5T-157N-d9Meg 
ST-177N'60Meg 



^0 MEG SCSI Pro Drivo „„ 
eo MEG SCS* Pro Drtvo .... 
100 MEG 3Ca Pro Dffve... 



63*? DEL 
669 DEL 
%9DEL 



thnt cards include IVS Trurnpcardctrtr. mount h^ 
tHtt cU. softwire, ind FREE dallwrir Inllvsoont- 



IVS INFINIT 40 



INRNIT40/I .1199 

INRNIT40S' ...1259 

INRNtTiJOD*.. 1399 

' Rpqufes Trumpcard of Tmnnpcqfd 500 



Seagate 



579 Delivered I 
799 Dellveredi 



Quantum Pro Drive 

40 Meg SCSf Pro Drive - 679 DEUVE^D 
80 M«g SCSI Pro Drive - 929 DELIVERED 
100 Meg SCSI Pro Drive- 999DEUVERED 

'm«« PocUgis^i rTCfudw Tfurrpcord 500 oncbiuiv. T 
fr»a CQ^^uojl USA 



TiUfnpQOrd 600 Rom EMpondM inetkMi 
^ ft13k • 1 MfO * a MiQ • 4 MEO ^ 



Seagate SUPER SALE 



ST-t25N 20 Msg - SCSI £69 

ST-tSTfJ 40 Mag - SCSI 349 

ST-177N 60 Meg -SCSI 5G9 

ST'225N 20 Meg - SCSI 2S9 

ST-251N 40 Meg - SCSI 375 

ST-277M'1 60 Meg - SCS! 449 

ST-296U 60 Meg -SCSI 465 



Quantum 



Pro Drives 

40 Meg SCSI Pro Drive........ 449 

80 Meg SCSI Pro Drive 699 

100 Weg SCSI Pro Drive 779 



ST-t57N49 Meg ....^.°?.^..^ 519 Del 

ST-t77N-60 Mag 749 Od 

Quantum Pro Drive 

40 M^ sea Pro Drivo 619 DR 

SO Mog SCSI Pro Ditvo ...... 869 Oa 

lOOMogSCSfProOilvo 949 DEL 

Cod f*atu w X^tnc 1 DMAs hon^. Hsvtabaot ROM jau*o- 
cey^ cifc ulfry, ^ pJn SCS tana , dbk. u^ftiw mo'XK^ 

REE DEUVHtY IH THi COIfflOUOUSia CTWtS 



XETEC Fast Card System 

HardDflv»PcickQg« tor Amiga 500 



ST-157N-49Meg .......?.,.,!... 699 Del 

ST-177N-6€ M»o 919 Del 

Quantum Pro Drive 

40 Meg SCSJ Pro Drive ...... . 79<? DE L 

80 Meg SCSJ Pro Dif^o 1049 DEL 

100 Meg SCSI Pro Drtve 1(29 DEL 

Syrtwm i re llJci™Aclaptt5f w^+h O u1titjOO+ [?^< , «ric toCL PB, 
r™5«huQ«, Rsit TMt drt, wttH «♦<*«■ A li^iffidtfd SCSI co&te. 

FI?EE DEUVEftY tH THE CONTHWJOOS 4a STATtS 



VIDEO PACKAGE 

PANASONIC UIO CAMERA 

16MM LiNS WITH VARIABLE IRIS 

COPY5TAND WOW UGHT3 

DIGIVIEW GOLD 

$419 DELIVERED! 



MASTER 3A Disk Drive 

lOlOCompolfbl* 6 IOC 



CALL US 
FOR ALL YOUR 

COMMODOIE 

' needs'""^ 



Pafa»wifc11B0 «W rcW NEW - I8S I 

Plf«4<yifc1!91NEW NEW NEW. „. C^L 

Piraimfc M2* NEW 24 Pin 290 I 

3HrNX-l000 ..., 159 I 

Star NX-1000 Mull Fbnt 2 NEW NEW NEW .„ 179 I 

Slar NX-1000 Rikibow (Dotor) £19 I 

SlarHy-2400 Z75 I 



Modems 



Amiga l^SU Modem By 

Avalex 1 200E 69 

AvalM 2400 IM 

Avattx2400£ 100 

AvaJtJt SGOO External NEWI .639 

Supra 24(Khi Internal A2000) 139 



Supra 2400 Ext. 
Modem & Cable 

• $125 • 

FREE DELIVERY 

to the 4ft CofititttJOUJi S<*Tet 



AMIGA SOFTWARE 



1943. 



300plon*„ 
3D Pool. 



...... 25.95 Cribbaoe Kh^Ski Kina .... 37.05 SoKJ o1 the Realm 24.95 LtbWB Siil Urty II ...,_., 31 .95 Page Setter ....,..„ £9.95 

„„. 31 ,« CiTM Buslef 19.95 SdWs of the An«fk:as Z5 95 LconardD S.9S Page Thhtef „ 59.95 

22.95 C-ybflf Comptex ...21.95 SoWRmfi 24.95 UwrsflfeKlt..- ,.21.95 P*[jefilp(K: Pfia^X 07.95 

A-T*lk3 „.. UM Dm Stmrn , 2$M Btil^t .....„.„., 18.95 LHoind Death 31.95 Pwy Pal W » 

AeOonFlflWsr ,..., ., 24.95 OMthb^mger 24,95 Grind Prtit CiKdit 27.95 Loolcworits 184.95 Phawr ,...,.. 54 95 

A(hant*oe. TIm 1 1 4 95 Dcfendw Of 7He Crown .... 31 ,95 Gawtilp 35.95 Lorib 0( the fusing Sun ... 31 .95 PfxHon PaJrt 2.0 ff7.9S 

AflArBumv „.„.,31.95 Duj^ Vir f or 2 „.....„... 31.95 HjIIj o( Monteniim .,...2S.95 Lukot 19.95 ptBton Paint Srjf»c« 19,95 

U^nBfnkom ,-™ „....„ 24.95 Owurb . 24.95 Hardball II ....28.95 M2 Amiga 147.95 Pholon Vkl*o : Cefl Artm. . ffT.M 

AmlffiOOS TooCot „™.„ 3e-95 Design 30 „.. ..„ 50.95 Harpoon ...._..„. CALL M£ Amiga Debuggw 77.95 PhtXon Video Transport .. 169.95 

Aryrragte... „ ..59.95 Doslgnaiaurus .....30.95 Harrbr Combat Slnub tor. 31 .95 Mddet ..,„ , 19.95 Pipe Dream 25,95 

Anim 4-D Jt. ....,.„ S7.95 DIflldrold ^ 59.95 HealW^w — 28.95 Magellan 1.1 118.95 Pbae I ScrJpl 92.95 

Anlrmlor Apprertkfi 174.95 Dlo(palf«3.0 .„...„„.. ., 64.95 Heavy Metal „ 2S.95 jUUgt Jotwiwn 51 Z 24.95 Planet of Lust 24.95 

Afwah Of Roma ...„., 22.95 D*Slv*?w GokJ 124 95 Hcros Of the Ltr^e ZS 95 Magic Jot»»on 1 Meg ...... 31 ,95 Pockel flockpb 25.95 

Aqui Blast ...23.95 DighvorlOD 82.95 HtWir „ .,„ .31.95 Manhyrttr- N«w Y&rt 31.95 Polipe Qiieall ORS 31.95 

Archpetagos 23.95 DlnoWarj ...CALL HotflnO™_«. 21.95 Maniac Ma ralon 28.95 PodolBadance 31.95 

Areioi .......28.95 D*)oMur Discovery Kl I .....^.95 Hd< InOne- Cffl*rMm>ttJ3.9S Master Ntoji 19.95 PoslKript Fonts A.B .Cea. 24.95 

Arkajukia ,.17.95 Dbk 2 Df»l( 28.95 Hostage 29.95 

Aun Artfc Wwn ^.95 Dtak Master ,..^. ..... 28.95 Hurt Fw Red October 31,9S 

Artjra , ......25.95 DbkMediinte „ „. 54.95 Hybrfs „ ..,..-,. 22.95 

Attack on LoodMi 22.95 Doe 2 Dos ....31 .^ Hyper Dome , ... aZ95 

Avweomo Arcade Pack 3 1 .95 Double D ragon „ 25 .95 I kari Wa rrto rs 24.95 Mkmi Vfce ... .„ „,„ ., 24.95 P ro Soocw 22 .95 

An ol Rage ....„ 31 .95 Doutf s Math Atiuarlum 43.95 Irriiana Jones-Actbn Qame25.95 Mk:Mon Hit [»sk *1 32.95 Pro Sound Deslan 96.95 

BlA D. .. - . ^^^. „„ 29 .95 Dr. Doo m*s Revenge 23 .95 I ndiana Jww Graphfc Adv.31 .95 Mkro Rche Rfer Pirn 1 1 4.95 P ro VkJeo GoW 1 74 95 

Buj ..„._.„ 19.95 Dra^pn force 31.9S lr»wvatool52 43.95 Mid Ma^ CALL PrtjWr1te2.5 ...„...e9,95 

B«JD.Jrf .. 28.95 Ongon'tLii- 33.95 IrttrFont., 89.95 MklR««udb VI. 1 „ 39.95 Pro^Draw 112,95 

BtlanoB ni Power 1990 31.95 Drain's Lair II ...CALL lr«MChango ...28.95 MklView 23-95 Prnfttsslontl PitfB 22895 

Bareimw... 23.95 Draw A-2000 159.9S IrlroCad 49,95 Might and Mag k: t) ...........37.95 Structured Cl^j Art 38.95 

Biiman 23.95 Dwgoon Master 24.95 I nv? store Advantage ...59.95 Mlghly Nwds 31.K> 

Btlman (Same i Movie) ... CALL DuiflPon Quest 31 .95 Invtsbn 1 34,95 ModeJer 3D „ 56.95 Prolonts 1 & 2 

Battle Chess .29.95 Duilap infiSes 47 .» It Came From TJie Deisert ,31.95 Movfe Setter 59.95 Project D+ Backi^i .-.30.95 

BitUe Hawks 1942 31 .95 Ban Pertartnef .„ 35.96 J4(* NJckfaus Sotf 30.95 Musfc Studo 2.0 49,^ Pnjspectof Maras of Zor ... Z5.9S 

BallleleckTh? Cr Hk Inc. .. 31 .95 Empire 31.95 JN Courses of 1989 .... 14.95 Musfe X ,. 10995 Pub games Z5.95 

30.95 Excolkince 1 Meg ......158.95 JN CourwDlsc II 14.95 My PilntData Dfjk ,. 17.95 Puzrie Storybook 25.95 



n^ffir 



¥57031 

tMiu Mitic Cwicl S«l 



Delvie Pbob Lai ^^^ 

Deloa Priil If 

D*f(cte ProdacUoat 

Delna VIdMi 11 „_.» 
Dtlcie Vldio m ^.^ 



A. SvecuU S(de! 

,__ _ 37.95 F/A-W lateitAplsr 



62,95 
.44.96 
.UM 
.W.«S 
.51,96 
128,9 E 
,e2.9S 
..94.95 



F/A-18 laAMtApUir 31 .IS 

Firrvl Feniata Ov 31.99 

KMf tt« TUet ..„„ 31 .IS 

Pe^eloot 31.95 

Poipfrnlreme „»«»»»«»„ 25 .95 

Saor^ Df Twitpk) .31.95 

WenerBaMMf ». 31.95 

Conitluleiivr'f Dbk _- 14.95 



Mavis B««»n lyplng 31 .95 Power Windows Z.5 .......... 54.95 

Mean18...„... 27.95 Precisely 48.95 

MedlaUne dt Art ,. 21 .95 Pr%i1 Master Plu» ...2495 

Meruce 19.95 ProScripl 28 95 



Ten^tatfls 38.95 

21.95 



SaudBarxll .... 

Bwrort 3 22 95 Eye of Horus ,. 24.95 Jigsaw .. 

Beyond DaA Caslb 21.95 F-198teanhRg»iter CALL Jlnki - 

BbodMooey ....„ .^95 F-40 Pursul Sim. 28.95 Joan ol Arc ..... 



...30,95 NelherwDrtl 22.95 QiickSiVef 41.95 S( 



.18.95 
.....28.95 



NcuDmjncw _... 23.M Qlx 22.95 

New Vorfc Warrtofs CALL Quarter Back ..._.... 42 95 



....M.96 Faw:!! .„.....„ 20.95 Journey 31.95 Night Force 28.95 Queslrontl 31 .S 



BkieJ 

Boaidmastef ,57.95 Fatty Talo Adven ..............29.95 Kampfgrupp* 37.95 Ntnbus .97.96 Rambolll- 22.W 

Boomeiald 25.95 Fabon _ „....„... 29.95 Karafonts HeadBnes 1 oi 2 44.95 Nxiear War 31.95 Rampage 

Brkjo ot th« Robot 24.9S 

Broadctsi Titer ...184.95 Fartavlslon.^ .. 

Can Do ...84.1 

Captain Blood 31. 



OtilkefatDf . 
Omega ,. 



24.95 

25,95 RasUn , ...„ ........25.95 

31 .95 Rjw Copy ...„. 34.95 



Add on Dbk f or Fakon ... 1 6.95 Karaf onts 3u bh«ad 44.95 

.........37.96 Khid Words V2.0 57.^ 

federalion .,...„..„ 31.96 KkigArthw'sQuwVBcaL 31.95 Otmiplay Bas«t«I:5Qo5 31.95 Red Lightnaig 3f7.95 

Fiendish Freddy .31.^ Klr^j-s Quest IV 31.95 On Lkve Pialinum ..53.95 ReelRsli'r 28.95 

Carmcn8anDlcij[/rime....23.95 Fine Print 28.95 Kingdoms of England 26.95 Operation Wo! 22.95 Rofiegade 2.95 

Carmen SanObgo/ USA ,. 31 95 Fiight SimtiatDr II 31 .95 KnigNs of Legend 31 .95 Optics 117.95 Rf^mkig Noleboolt ,.. 3t.95 

ChcMmisterSOOO ., 28.95 EuroiJean Scerery Dsk . f 9.95 Krislil, Tlhc ..- „31.95 Oswald. .23.95 RfckDangetoui 3t.95 

ClBSsmajter 2100. 31.95 Bow , , .59.95 Lancobt „._.31.95 Oulrw ............31.95 RtigSide .24.95 

Ctronoquesl 32.96 Fticus Vid«i 107.95 LasI Dud „... ..24,95 Pjgo Renders 3^D 94.95 Road Chaifenge 24.95 

Cly Desk2.0 _ 112:95 Forgotten WortJs ..,.,. 24.95 Last Inca, The 24.96 Page Stream 127.95 Road Raider 24.95 

Ckte ktasief Oetedive ....... 25.95 Frfghl NS^^I .„ 24.95 LeauneSuttLany ..,.25.95 _ ^ Ont Matrix Font1-5 ...ea. 24.95 Roboso p .2895 

CakKV ...™ ,.^.,-3195 Front Page .__„ - ..74.95 """ 

Combal Covk - 25 95 Fulijro Sound 500 89 96 



Ccmfc: Sellw 59.95 Balaclic Comjueror 28 95 

ConUc Art DbVs {wch) 20.95 Gaunttot II „,. 31 .96 

Contra 25.95 CeHyiiuro 37.95 

7iffl m»^^'^ SL^ 




MpirCard 



AMI o&i S i» cwiNOM fi a«a im. t)«- 

SU^FRCa^.- (6M COlO«»UTII« 

iVPtH CtN J00e» IKT GCNIOCK .„ „ %)4i* OOUl DISK SCANNItt 

MASH] tBOd GEN iOCK ....^ I IMf IMO SCAN 

rUCKIBfOHB .„...,.,...- -iJM SCAN IDCK 

>EBftCTSO!JNP , .-.,. i*^ CW<<0»ACC 10 ,.^.^ 

NO CREDIT CARD 
SURCHARGE 




Rocket Flangcr 

RcgerRabbft 

Romantfc Enct O Dome .. 

Rubton Allanc* 

«VF Honda 

Savage 

Scawnger 

Scrabble 

Scrfcble Piathum 

Sex Vixens-Outer Spaoa , 

Shadow of the Beast 

Shtrwbl 

Shogun 

Sfniffepuck Caffl .,...„„... 

Side Aims 

8Iti City 

Sky Shark 

SorcflforLord 

Space Karrler , 

Space Quest 1 or 2 

Space Qu&st 3 „. 

Spac« Flacef 

SpeedbaH 

peedbuggy 

Stir Ray 

Star Tr^: The Fk\al Front 

Star Ware , 

8tBlar Crusade 

Bbost FigtKor 

em p Poker ff 

Si^rBick 

S^wrbase Personal 

Sufjerbase Personal 2 

SuperBase Pro 3.0 

8uperplan 

8uperstar loe Hjckey 

ewordOfSodan 

TV. Sports Baslcetbail ... 

TV. Sports Foot ban 

Talespin 

Targfian 

Tempte of Ooom 

Teliis .,., 

TeUEdPkjs 

Tent Drt« 2 - The Duel ,., 



.31 95 
..J8 95 
.25.95 
.20.95 
.24.95 
.22,95 
..CALL 
.26.98 
.87.95 
-22.95 
.31.95 
.31.96 
.31.95 
.24 96 
,24 95 
.28.95 
.22.95 
.22.95 
.31,96 
.31.96 
..CALL 
.19.95 
.24.95 
, 21 95 
.29,95 
30.95 
.24 96 
.34.96 
.25.95 
.23.96 
.43 95 
.46.95 
.37.96 
189.95 
.87.95 
. 31 95 
,28.95 
.31.96 
.31.95 
.31.95 
.24,95 
.31.95 
.20.96 
.48.96 
.27.95 



"LHP*tht,„ 



jiS^ 



Euro{>ean Chal ,., 14.95 

Supetcars 14.95 

Tbejaief .....,..._. .....22,95 

Thdr Hrwat ^v. Wkki ^ 37.95 

Thhkaf S7,9S 

Thkd Courier 28.95 

T^ree DerrxMi .............89.96 

Thunder 8U* 29.95 

limes of Lon ...._—.. 24.95 

Tracers ™.__.-«„ 22.95 

Trtracripts „„,_. 419S 

Turbo ....„ ..15.95 

Turbo Sifvw 3.01 Meg ...112.95 

TV Show „...,„ W.95 

WTert 84.95 

Twii^jt* Zow _.. 24.95 

Twli^tt's Ramom ,19.96 

Ullma4. 38.93 

Ullma til _. , 24,95 

UriwreeS ,„.-,.™ „3t.9S 

Vamplm'* Empire 28.96 

Vetetati... 19.95 

VWw Effects 3-D .113.95 

Vbeo Fonts .,..„. ...2896 

VbeoScape 3D 2.0 1 1 5.95 

VIP PrtilffMbnal S9.95 

Virus ir^eclton Protectksn . 28.95 

Vista 3-D -.....„ 87.95 

VTX Onihe .„.......- St.flS 

W»wl .28.95 

War in Midik! Eartfi 29.a 

Wayne erBl?ky Hockey 29.96 

Wekd Dreams .24,95 

Who. WhaL When .„... 84,95 

Willow ...25 95 

Wind Water ...25.95 

Wings OtFijry 25.96 

Works PlatkitfTt CALL 

WorkiABas „.,.„.,. 35.95 

WorUCbss Leader Board 28.95 

X-Specs „.. ...84.95 

Zak McKncteo 28.95 

Zoetrope „„„„. _. 82.95 

ZoTkZero ^. „„.. 38.96 




wi onoEns and infoamahon 

414-357-4181 FAX4l44E7"7ail 
P.O. BOX 17SS2 MIlMUhat, Wl uei? 



ordK. P«f tonal Arid oompany cTiKktalow M butinm d^« ic ci*a'. ^tfiooi P.O.'f wv^ccvn*. aaO. 



ivg** arm 14.00. in Ctfittn«nt>l U.fi.A. Inciudi SS.CW fOf 
^ HL AK. FPO. APQi>i^*rbT%tB crd Cvwlkn onten, p^WM add e% ih^ptn^ Mhrmur 

"*fl numtMif, P'*aMt:a;it*'4)357.StS1 to obW»i *ft RA. • w ywif nrturr wfl f»* ft* 




PIC-MAGIC™ 

Professional Quality Clip Art Package One 
Over 250 Imaqk 

OvER-SCREEIM-SiZCd BlT MApS 

Ten Disks 220 PAqc ManuaI 

Food 

Sports 

Cars and other 

Wonders 

Christmas 

People 



Topics iNcludE: 



Plants 

Animals 

Misc. Objects 

Places 

Bordersets 

Eye Grabbers 



Call the PIC-MAGIC^" Hot Line 

1-800-387-8967 




Or Send Cheque or Money Order To; 

Joe's First Company Inc. 

P.O. Box 579. Station Z 

Toronto, Ontario MSN 2Z6 

Tel: (416) 322-61 19 
Fax:(416)489-1620 




Circle 180 on Reader Service card. 

1 2 PLUS 7 4 3 
LENGTH ERROR 
[1] R ^ X +Y 

A 

which is exactly what should have happened. The user-defined 
functions are not wanted to have different rules and do things that 
mathematics cannot do. 

APL functions can be written in six different forms. Two of 
which have been dealt with, those that gave an explicit result and 
those diat did not. One argument was seen on tlie riglit. Two 
argument were seen, one on each side of the program name. One 
of the other two forms involves neitlier arguments nor an explicit 
result, i.e, just a program name, as the first version of AVERAGE 
above. The last of the six forms uses no arguments but produces 
an explicit result. The following table shows xhe six forms for any 
function FUN; 



Number of 

Arguments 


No 


Explicit 


Result 

Yes 




1 

2 


FUN 

FUN Y 
X FUN 


Y 


R ^ FUN 

R ^ FUN Y 
R <- X FUN Y 



A defined function may be used in the same way as a primitive 
function. The following function "SR" extracts the square root from 
its right argument and returns an explicit result: 



V R i 
[1] i? <- X 



SR X 

.5 V 



The calculation (line [1]) reads: "R is specified by the value at the 
local variable X raised to ±e one half power." 

If the above function is called widiin another function 
"HYPOT" to find the lengtii of the hypotenuse of a right triangle: 



V j^ 



tl] R 



A HYPOT B 

( A * 2 ) + B 



2 V 



It is shown tliat a user defined function can be called from within 
another user defined function. There are no limits to \hc deptli of 
function calls, that is until the amount of memory available is filled. 
A function can call itself witliin its body, becoming a "recursive" 
function, a topic for a later session. 

To use tlie function "HYPOT" tlie lengths of tlie two sides 
must be supplied as arguments: 



12 HYPOT 5 



13 



The first line of the function HYPOT can be read as "R is specified 
by die result of the fimction SR (the square root), which took, as its 
right argument, die quantity A raised to die power of 2 added to 
quantit^^ B raised to die power of 2. As described, APL uses "*" tlie 
primitive function notation for die mathematical function "power." 
A diird set of parentheses, around "B * 2" was not needed since APL 
has a very interesUng rule for order of execuUon. Alas, that story will 
have to wait for die next time. 

The previous illustration of how easily one function is called 
from widiin anodier indicates another su:engdi of how APL 
operates. Of course, in the above examples, neither the function 
PLUS nor SR were needed as diose ftmctions could have been easily 
written into an APL statement widiout writing a function. PLUS 
simply showed die power of APL's function capability and used die 
most familiar function that exists in math, HYPOT could just as 
easily have been written as: 



[1] ^ 



R <- A HYPOT B 
- {{A ^ Z) + B * 



2) 



.5 V 



where the square root was taken as the last operation outside the 
parentheses, by raising the quantity inside die parentheses to the 
one-half power. 

The next article will look more closely at the order of 
execution of the extensive number of operations, and it will explore 
more of the newly defined primitive funcdons. 



'AC' 



Spencer Organization, Inc. 

P.O. Box 248 

Westwood, New Jersey 07676 

(201)666-6011 

APL Inferprefer for the Amiga. $99.00 

Inquiry #221 
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SNAPSHOT 



by R, Bradley A ndrews 



Another month, another column. I 
would like to begin this montli by making 
an outright request for feedback. What do 
you think about the format? Should the 
reviews be longer or shorter? In addition to 
writing me in care of the magazine, I am 
also accessible on tlie GEnie information 
service under tlie name of R.B.ANDREWS. 
I have started a topic in the Amiga section: 
Category 6, Topic 63. Give me your feed- 
back! 

Universe 3 

This month, we have the final chap- 
ter in Omnitrend's Universe trilogy. Uni- 
verse 3 concludes tlie futuristic adventures 
of our beloved captain, Aiex Seward, as the 
colonists of die Federated Worlds attempt 
to reopen communication witli the Home 
Group, 

Universe 3 is different from the pre- 
vious two games; those of you looking for 
another trading-style game will be disap- 
pointed. The game is more a combination 
of the traditional graphic adv^enture with a 
Breach-like interface dirown on the top. 
(Breach was a man-to-man level combat 
simulation they released several months 
back,) 

The game begins in tlie Spaceship 
FWS Union just after its arrival at die planet 
Ambergris, die return point for people from 
the Federated Worlds. As the captain, you 
must gadier up your crew, revive (from 
cold storage) some important passengers, 
and take your landing party down to the 
reception facilities. Once there, you must 
work your way to a final meeting, uncov- 
ering the bad guys along the way (aren't 
there always some?) and restoring good 
reladons to humanity's far flung outpost. 

The puzzles are all fairly simple to 
solve, though a few did have me rather 
frustrated. Nearly all objects have a single 
use in the game, even leftover food wrap- 
pers. 

The mouse is used for all input. Most 
common actions have graphical icons on 
the display screen, while odiers can be 
constructed through the use of menu 
choices. While limiting the available ac- 
tions, this approach is much better than an 



open-ended parser since you can know 
immediately which actions are possible. 
Even so, the game is not that simple. 

The graphics are the game's low 
point. For some reason, the artist used 
colors reminiscent of CGA mode on die 
IBM, While tlie aitu^ork is much clearer, it 
stOl falls a bit short of Amiga standards. 

The game will not take that long to 
finish. If you are adept at solving puzzles, 
you should be able to wrap up tlie entire 
mission in sbc to ten hours. During play, use 
the "save" and "save as" features often. This 
will allow you to replay a section if you 
make a wrong choice. 

On die whole, Universe 3 is a so-so 
product. I found it moderately entertaining, 



but I question whether it has enough play 
value to justiiy its cost. 

Prison 

Next on ±e list is Prison, the latest 
Action ware release for the Amiga. 

Once you were a high-level enforcer 
for the Galactic police. But you have been 
framed. After sending you in to mop up a 
sizable cocaine ring^ tlie commissioner 
charged you with murdering ten innocentj 
flour-covered bakers. Your trial was a farce 
and you have been dropped onto die 
inescapable prison planet, Altrax, Lacking 
any betier way to care for criminals, an 
entire planet has been cordoned off and 
dangerous criminals are permanently 
(continued on page 18) 



UniveiseS^ 

The final 

chapter in 

Omnitrend's 

trilogy. 




Press FIwv Kev 

FOR MORE,.. 



I f\H } riNFiLLV ft FLftCE iJITH 50ME LIFE XN THl£ T-jUS! ■ 
I ThxS BUILOI^JG FRC'CLmIMS IT5ELF TO BE THE PFiLRDl!^ 
IROADHOUSE^ PURMEVORS of fine food fiWD DRINK. 



PriS07l: 

You 've been 

framed; now yon 

must fight your 

way out of Altrax. 
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PRIME! 



mm 



if.'-. 



II 



IT 



toETHJ 



^n.^ u^ <>te^I>Kiu,v> lii/#^ And lna> 
P 1 Vvi)lni¥-bt^^n:ij.r fxj^red. Multi-I'orih 

VlcjWsJ 
Hardi^are firttjL i; 



an 



tducattpns 

rht^niig;i Attends Ru^yeis 
Re:Mrn^. KTHTrv. anti /ftc^< »lu 

A H \n!C TvpiW Tutorial Procftdii 



issue of AC is created with one goal in mind — the reader. AC believes in the basic 
adage, "Give the public value, and you will be valuable to the public." Providing 
value has allowed AC to grow with each issue and develop a publication unmatched 
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(Snapshot, continued from page 16) 

dropped onto its surface, never to be heard 
from again. 

But there is one hope. Rumor has ic 
that, several months back, a pleasure 
cruiser strayed too close to Altrax and was 
shot down by the orbiting defenses. While 
the ship itself was destroyed, a one-man 
escape pod supposedly made it safely to 
the surface. It is up to you to find the pieces 
of this pod and use it to escape and correct 
your unjust conviction. 

Prison uses the side-angle view of 
your on-screen alter ego common in many 
arcade action games. In addition to move- 
ment to the left and the right, you can also 
move into and out of the screen at certain 
doorways. While you begin only witli your 
wits and physical strength, many things are 
hidden along the way to help you on your 
quest. But many booby traps also hinder 
progress. We wouldn't want tliis to be too 
easy, would we? 

Prison is another puzzle-solving 
adventure. Certain items must be located 
and used in order to proceed. While most 
games of tliis type allow you to carry 



several items, you have only hvo unused 
pockets for holding things, and must there- 
fore choose what you carr>^ carefully. For- 
tunately» each item only has one use and 
can be left behind after this time. However, 
some items have no use at ail, so don't pick 
up everything you find. 

In addition to its human occupants, 
many alien-type entities have been ma- 
rooned on tliis planet and would like 
nothing better than to have you for lunch. 
You are well advised to learn tlie metliods 
of hand-to-hand combat early in the game 
so you can quickly do tliem in when tliey 
attack. Each time you are injured, your 
current strength level is reduced; when it 
reaches zero, you lose one of your three 
precious lives. VCHiUe scattered food can re- 
store your strength, nothing can restore a 
lost life, so be very careful. 

The graphics used in the game are 
impressive and do exploit the Amiga's 
capabilities. The \aews are \^ery well done 
and provide a life-like backdrop for the 
decrepit prison planet setting. The sound, 
while simple, appears to be in stereo and 
adds flavor to gameplay. 




Project Neptune: 

Destroying the 

Yellow Shadaotu 's 

underwater bases. 



Deja Vu IL 

Haven 't I been here 

be/ore before? 



The game spans se\' eral locations on 
the planet's surface and will take many 
hours to complete. Many nights of gaming 
will be required before you finally gather 
all three pieces of die escape pod and 
rocket your way to freedom. 

Two flaws mar an otlierwise impres- 
sive game. Several of die screens are ver>' 
difficult to cross because of tlie inaccuracy 
of die controllers. Moving a slight bit can be 
difficult and I often landed on one mine 
when jumping anotlier, or fell down a life- 
stealing hole that I had tried to clear. If this 
were an arcade game, I could understand 
die need for such obstacles, but for this 
style of game they are a bit extreme. The 
game's single save slot also hindered suc- 
cessful play. I often had to replay the entire 
staning sequence because I had saved die 
game at some point after missing a vital 
component I would need later in die game. 

Wi± ihi^sc in mind, I still highly 
recommend die game. Take the time to 
map each area and figure out the best way 
to proceed on your quest. Prison has a very 
high entertainment-to-cost ratio. 

Project Neptune 

Next on the list is Project Nepame, 
from Epyx. The infamous world arms 
dealer, the Yellow Shadow, is mining ura- 
nium off the coast of Norway to use for 
building nuclear weapons which he can 
dien sell to die highest bidder. Naturally 
NATO leaders are concerned about this 
and want to put an end to die whole 
operation. 

Fear of an adverse public reaction 
prevents an overt strike on tlie area and the 
job has been turned over to you. In your 
specially modified research submarine and 
outfitted with die latest diving gear, you 
must destroy the Yellow Shadow's com- 
plex before he gathers enough uranium to 
act out his plans. 

To stop him, you must destroy his 
underwater bases and the patrols that 
protect them. While you can take on the 
patrols one by one, the best way to termi- 
nate them is to eliminate the bases that 
support their actions, and the only way to 
do this is to blow up all die links connecting 
the base to die rest of die ner^^ork. Once 
the links are gone, the base and its patrols 
will be useless. 

During your mission you will en- 
counter three types of patrols: Defense, 
Warrior, and Worker. Defense patrols con- 
sist of two defenders who stay with each 
base to protect it from attack. Warrior 
patrols are composed of six warrior divers 
(continued on page 52) 



18 Amazing Computing V4 J 1 ©1989 



FastPixO 



A Faster Pixel-Drawing 



Routine for the Aztec C Compiler 



by Scott Steinman 

For a long time, graphics 
programmers have known that while the 
ROM Kernel line-drawing routines are 
fairly fast, the pixel-drawing routine 
writepixelO is very slow. This is due largely 
to the actions of tlie blitter chip. This lack 
of speed has prompted several software 
developers to develop tlieir ow' n assembly 
language pixel-drawing subroutines. This 
article will show^ you how to speed up your 
grapliics programs using a streamline, yet 
fairly general, assembly language routine 
designed to be called from C programs, 
(The code was written for use witli non- 
interlaced screens, and has not been tested 
on interlaced screens.) Some unexpected 
principles of linking assembly language to 
a specific high-order language (Aztec C) 
will also be explained. 

In an earlier issue of Amazing 
Computing, Gerald Hull outlined the 
theory underlying the linking of assembly 



language subroutines to high-order- 
language (HOL) programs (see "Linking C 
Programs with Assembler Routines on tlie 
Amiga," VT7, p. 79). That article described 
how the formation of local stack frames 
(LSF's) facilitates the passing of parameters 
from the calling C program to the assembly 
language function. Rather than using one 
general stack for shared use by all program 
functions G:^oth C and assembler), the LSF 
philosophy divides the stack into smaller 
subsections, each of which is used 
exclusively by one C or assembler routine 
as it is called. A local stack frame is set up 
when tiie assembler function is called. 
Parameters are passed between the C and 
assembler routines via the LSF, which is 
removed when the assembler function 
exits. 

While the LSF approach works well 
for interfacing C and assembler code, and 
should be used whenever possible, it has 



one shortcoming—it requires extra code 
and processor time to be implemented. 
This is a serious drawback for functions 
that must be called and executed rapidly 
and repeatedly; it is one of the many 
reasons why even low-level languages 
such as C are slower than assembly 
language. For routines that must be fast, 
local stack frames must sometimes be 
avoided. In tliese situations, it is simpler to 
set up global (that is, permanently stored) 
variables in advance for those values that 
remain unchanged ever^time the assembly 
routine is called witli your C program. Only 
those variables that must be changed with 
each function call are passed directly onto 
the stack (without a local stack frame) as 
parameters. 

Storing global variables in C and 
subsequentiy using them with assembly 
language subroutines is quite easy, as 
you'll see below. However, passing 
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FIGURE 1: BitPlane Address Calculations- 

The bitplane is divided into bytes, each of which 

represents 8 pixels on the screen. Each screen row 

contains WIDTH/8 bytes, and there are HEIGHT 

rows. The leftmost screen positions are at bytes 

BitPlane + (ROW '(WIDIH/W), 



FIGURE 2: Color Values and the Bitplanes- 

At a giveti pixel position, each bit of the color value determines whether 

the corresponding bit in its bitplane is set to 1 or cleared to 0. In this 

example with 4 bitplanes (DEPTH - 4), a color value of 5 means that 

the bit correspotiding to the pixel is set to I in Bitplanes and 2, and 

cleared to in Bitplanes 1 and J. 
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infonnation onto the stack is a little 
confusing at first. The Aztec C manual 
explains how this is done in ti:ie 
"Technical Information" section. 
Unforuinaiely, an undocumented 
action of the compiler can result 
in a departure from these ideal 
conditions. In particular, die 
manual states that integer 
parameters are pushed onto the 
stack and retrieved from tlie 
memory location starting four 
bytes beneatii tiic stack pointer. 
Additional integer values are 
found e\'er>^ v^'o bytes beyond 
this. 

All diis is certainly taie 
when code is compiled with 16- 
bit integers, but Uouble can arise 
when the +L (32-bit integer) 
compilation option is set. In the latter case, 
parameters are stored on the stack as long 
integers ever>* four bytes; regardless of 
whether they are declared as long or short 
integers. This means that the first 
parameter is stored as a long C32-bit) 
integer in die 4-b>te sequence starting 4 
bytes below the stack pointer (bytes 4, 5, 6 
and 7). However, if you are really using a 
short-integer argument, the top 2 bytes 
allocated for ±e long integer (at 4 and 5 
bytes below the stack pointer) are 
unneeded. You can retrieve your short 
integer from die memory location 6 bytes 
below the stack pointer (the word at bytes 
6 and 7). The second argument will be 
stored as if it were a long integer starting 8 
bytes below the stack pointer, and so on. 

Program Needs 

My application program required 
fast, repetitive pixel drawing, but it also 
used several shareware and commercially 
available libraries diat had been written 
specifically for 32-bit integers. Therefore, 
the assembly code had to account for the 
idiosyncrasy of 32-bit integer compilation. 
I have left the code in this form to 
demonstrate ±e principles of linking 
assembly language to 32-bit integer C code. 
If you want to rewrite the code for 1 6-bit 
compilation, follow tlie function-calling 
rules provided in the Aztec C manual. 

Before we look in detail at the 
assembly source code for the FastPixO fast 
pixel-drawing function in detail, we must 
discuss how to prepare tlie C program for 
its use. In order to keep the execution time 
of the fast pbcel -writing routine to a 
minim Liin, several unchanged parameters 



are computed singly in advance each time 
the function is called. These variables are 
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stored in global variables direcUy 
accessible to the assembly language 
routine. 

The first variable is related to the 
number of bitplanes (called "nplanes" in 
the program) on the screen. The program 
needs to set die color of the pixel to be 
drawn. To do tliis, nplanes must modify 
the contents of die bit corresponding to that 
pixel in each bitplane, and must know how 
many bitplanes to examine, test and 
change. The second global variable, die 
pointer array called *bp[DEPTH], is an an-ay 
of bitplane starting addresses. It is stored 
when the bitplane memory is initially 
allocated widi die AllocRasterO function. 

Finally, in order to draw die pixel, 
you must be able to determine rapidly 
which byte to modify widiin each bitplane. 
You could simply count bytes along one 
row, and dien along another, until you 
reach your pixel location, but this is time- 
consuming. To save time, store in advance 
the number of bytes you must add to die 
bitplane staiting address in order to reach 
the leftmost pixel in each screen row. This 
gready simplifies later assembly language 
calculations. These byte-offset values for 
each screen row are stored in 
ytablelHEIGHT]. 

Code Calculatiotis 

A code fragment in C which sets up 
these variables is shown in Listing One. 
Let's discuss the calculations of this code 
fragment. First, the screen height, width 
and deptli are defined (with #define) at die 
beginning of die program. When you are 
ready to allocate bitplane memory— either 
direcdy, via the ROiM Kernel AllocRasterO 



routine, or indirecdy, via Inaiition — you 
must set up in advance an array of pointers 
to hold the bitplane starting 
addresses. One pointer is needed 
for each bitplane, so the size of the 
array is equal to the screen depth. 
When using the ROM Kernel 
routines, set each bitplane address 
to RastPort^^BiuMap/EPlanesD. For 
Intuition-based programs, find the 
bitplane addresses at 

WindoWi^Rasa^ort/EBitiVIap/EPlanesD, 
(The exact name will depend upon 
your variable names for the 
window, rastport and bitmap.) 

The next variable to be stored is 
nplanes, the number of bitplanes. 
Why store this if you have already 
defined DEPTH? First of all, tlie 
assembly language routine must 
receive this value, and it won't see die 
definition if it's compiled in a separate 
source file. Secondly, what you really need 
is DEPTH - 1 , which is the array index of the 
first bitplane that you'll modify (remember 
diat in C they will be numbered 0, ... , 
DEPTH - 1). Accordingly, set nplanes to 
DEPTH - 1. 

Finally, fill your bitplane row-start/ 
byte-offset table (see Figure 1). The address 
of the leftmost pixel in each row widiin 
each bitplane is equal to die address of tlie 
previous row in the bitplane plus the 
number of bytes used to store all of the 
row's pixels. If you use a low-resolution 
screen, each row will contain 320 pixels, 
each represented by a bit in the bitplane 
memory. This translates to 40 (320/8) bytes 
for each row of pixels. Therefore, the 
address difference between tlie start of one 
row to the start of the next row is 40 bytes. 
This number is doubled for a high- 
resolution screen, which is 80 (640/8) bytes 
across. 

Instead of calculating the number of 
bytes offset from die top of the screen 
(b>aeoffset ^ bitplane starting address + [y 
• widdi/row-bytes] + [x/column-b>tes]) 
each time you enter the FastPLxQ code, 
precompute an array of row-offsets (in 
bytes) from the bitplane starting address for 
every row (ytablelHEIGHT]). For example, 
in the lo-res screen, offset is bytes, offset 
1 is 40 bytes, offset 2 ii 80 bytes, etc. 
Therefore, if you are working with bitplane 
0, die address of row is bp[0] + ytableLO] 
= bp[0] + 0, diat of row 1 is bp[0] + ytable[l] 
= bp[0] + 40, and so on. Now when you 
need to find die specific b>te in a bitplane 
which you must work on to change a 
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pixel's color, you need only the pixel's x- 
and y-positions on the screen. You can 
then simply look up the ytable[yl to the 
pixel y-position to move down, and then 
add x/8 bytes to that value to give you die 
amount to move over horizontally. 
Accessing the individual pixel is done by 
looking at the bit that corresponds to your 
pixel within the byte. Precomputing the 
row-offset array ytableQ saves several 
computational steps when tlie function is 
being called many times. 

Using FastPixQ 

Now you are ready to use the 
FastPixO function. It is called by the C 
program with three short-integer 
arguments: the x-position of tlie pixel 
(screen column), the y-position of the pixel 
(screen row), and the desired color of the 
pixel. These three values are pushed onto 
die stack by the calling function's code and 
by the entry of the assembly language 
FastPixO routine. Note that the pixel's 
color is included in the function arguments. 
This means that you don't have to call tlie 
ROM Kernel SetAPenO routine each time 
you want to draw a pixel, saving yourself 
even more time. 

At the top of the assembly source 
code in Listing Two, the machine processor 
(Motorola 68000) is defined. This 
definition is optional in the Aztec 
assembler, but it is nice to be 
reminded that the Intel 8088 
processor family (Boo! Hiss!) is not 
being used, Tlien begins the code 
segment of the prognmi (CSEG), in 
which all external code modules 
are allowed to refer to the assembly 
code with tlie XREF directive. 
Remember tliat variables and 
function names are given a 
beginning underscore by the Aztec 
compiler, Tlierefore, the function 
must be called _FastPlx in the 
assembly source code if it is to be 
visible to the C program. 



Code Processing 

As tlie assembly code is 
initiated properly, the parameters that have 
been put onto the stack as function 
arguments must be able to be retrieved by 
the calling C program when it calls 
FastPbcO. These parameters are the values 
that may be different each time Fasa^LxOt 
the pixel location and its color are called. 
Remember that tlie first short-integer 
argument may be found 6 bytes below tlie 



stack pointer. It holds the x-position of die 
pixel. The second short-integer argument 
is 4 bytes away from this, 10 bytes below 
the stack pointer. It holds the y-position of 
die pixel to be drawn. The last parameter 
is die color number of the pixel. It is stored 
in tlie third short-integer argument, 14 
bytes below the pointer. 

First, the pixel y-position (ten bytes 
below the stack pointer) is loaded, and 
then it is stored in tiie general data register- 
-DO. The y (or row) value is used as the 
array index of the y-offset table y tabled, 
(Remember: tlie address offset of the 
beginning of each screen row is stored as 
ytablely].) In assembly language, array 
members are accessed indirecUy from their 
addresses, which are offsets from the 
beginning address of the array. Addresses 
are stored as long integers, so the short y- 
position variable stored in DO must be 
converted to a long integer in order to be 
added as an offset to tlie array starting 
address. The ext,l opcode accomplishes 
this task. Also remember, however, that 
each array member in the array of shorts 
I'AkiiS up two bytes. 

The C language takes tlie array 
member's size into account when it uses 
array indices (in assembly language, this 
must be done manually). In order to use the 
y-position as an array offset, you must 
multiply it by t^^o in order to move two 
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bytes per array member. The 
multiplication is done simply with a 
leftward aritlimetic shift (asl) of the 
contents of DO. The ytableQ array starting 
address (assembly global variable _ytable) 
is loaded into address register AO, and array 
member ytablefy] is accessed by loading 
the contents of both address AO (array start 
address) and DO (array member address 



offset) into register A2. The address of the 
byte at the beginning of row y now has to 
be stored in register A2. Next, the pixel x- 
position, stored in tlie parameter 10 bytes 
below the stack pointer, is loaded and 
stored in DO, It is then stored in a long 
integer, as done above. By dividing this x- 
value by 8, you can obtain tlie byte offset 
from tlie beginning of the row to your pixel. 
For example, die pixel at column 124 is in 
byte 15 (124/8) from the start of that row. 
Arithmetic shifting to tlie right 3 times 
divides by 8 quickly. Adding the offset 
from tiie start of the row to the address in 
A2 (row start address) provides the total 
pixel-byte offset from the starting address 
of the bitplane (the bitplane 's upper left 
comer). 

Next, isolate the individual pixel 
within the b}T:e that represents the pixel. 
Remember that each bitplane byte contains 
8 bits, 1 for each pixel. Unfortunately, the 
bits in die b>te are stored in the direction 
opposite from what you would expect from 
the order of pixels on the screen! The 
leftmost pixel in the byte is stored in bit 7 
(the highest bit), die next in bit 6, and so on. 
Moving left to right on die screen, the bits 
must be used in descending order in each 
byte (see Figure 1). 

Therefore, to access die pixel you 

have to flip the brae's bits. How is this 

done? First, the pixel offset is needed from 

the beginning of the pixel byte. 

This is really a modulus 8 division 

of the pixel x-position. In other 

words, if the x-position is 263, the 

byte containing the pixel is 32 

(263/8) bytes from die row start. 

But this stops at pixel 256. The 

pbcel needed is 7 (263 - 256) pixels 

away from this point. A modulus 

8 division of 263 would move the 

7 extra pixels. Tliis division is easy 

in assembly language. The x- 

position is stored in register D2. 

Now all that needs to be done is to 

mask off the lowest 3 bits of D2 to 

divide modulus 8, This number is 

subtracted from 7 to get the pixel's 

bit number witliin the byte. Thus, 

7 pixels become bit 0, 6 pixels bit 1, etc. 

Store the immediate number 7 in register 

DO, tiien subtract D2 from it. 

Next comes the major loop of the 
code. The pixel values must change in 
each bitplane in order to set the pixel's 
color. The number of bitplanes is 
determined by the depth — or, in this case, 
the global variable nplanes. Start with the 
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last bitplane, bp[nplanes], and work downward to the first bitplane, 

bp[0]. nplanes are stored in D3, which is to be used as the loop 
counter. 

As the pixloop is entered, change D3 from a counter to an 
address array offset, and then store it in DO. This is done because 
an array of pointers, bpD, must be used to get the starting address 
of the current bitplane in each iteration of the loop. The already 
calculated pixel-byte offset from A2 is then added (extended to a 
long, now in Dl) to the starting address of the bitplane to get the 
address of the pixel within that bitplane. 

Pixel Color 

Now tliat tlie location of the pixel is known, a more important 
question muse be asked: How do you know whether to set or to 
dear that pixel in that bitplane to get the desired color? Luckily, the 
color parameter provides this information (see Figure 2). The color 
parameter is the color value exactly as it is used in the SetAPenO 
command. Each bit in the color is the pbcel's representation in each 
corresponding bitplane, so that color bit determines the state of 
the pixel in bitplane 0, color bit 1 is used for bitplane 1 , etc. A color 
register value of (everj' bit has a in it) means "clear to the 
corresponding pixel bit in every bitplane." A color register value 
of 5 (binary CX)101) means **set the pbcel's bit to 1 in plane 0, clear 
it to in plane 1, set it in plane 2, and clear it in planes 3 and 4." 

In otlier words, all that needs to be done is to read 1 bit in the 
color variable for each bitplane to see if the bit in that plane for the 
pixel in question is set or cleared. The color parameter 14 bytes 
below tlie stack pointer is used to test if the color bits were set with 
the btst instruction. When the loop is run for the first time for 
bplnplanes] (loop counter D3 contains nplanes), it reads bit nplanes 
of color and tests them. If it is set (1), die bitplane pixel is set by 
branching to the setpixel code segment; if not, it is cleared in the 
clearpbcel segment. In the first case, the pixel's bit is bset to 1 within 
its bitplane byte. In the second, the byte is bset to 0. At this point, 
go through the loop again until the pixel's bit has been checked and 
changed in all of the otlier bitplanes. Finally, exit from the FastPixO 
function and end the code segment. 

Data 

The data segment (DSEG) is at the bonom of the source code. 
Ail it does is tell the assembler that the global variables used in 
FastPbcO are externally defined (XDEF). That's all there is to this 
program! 

Routine Speed 

The speed of the FastPbcO assembly language routine is the 
result of four factors; (1) it is written in assembly language to access 
the bitplane memory directly; (2) tlie use of local stack frames (LSF) 
is avoided, saving setup time every time the function is called; (3) 
commonly used constants are calculated in advance and stored in 
global variables; and (4) the ROM Kernel SetAPenO routine does 
not have to be called each time you wish to change colors, saving 
the time needed to call and execute a second function. 

The systems programmers at Commodore have done a 
wonderful job of writing extensive graphics softu^are that the user 
can utilize in his or her own programs. In order to make AmigaDOS 
and the ROM Kernel easily updated, most of the operating system 
was written in C. However, we sometimes pay a price for this in 



speed. In those cases where speed is of the essence, it is fairl>' 

simple to replace selected Amiga C routines with custom assembly 
language routines. This article should sers^e as a guide for writing 
assembly language specifically designed to speed up C programs. 
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Listing One 



LISTING 1: C set-up code 



# define DEPTH 
i define WIDTH 



4 
320 



# define HEIGHT 200 



UBYTE 

Short 



short 
short 



*bp[DEPTH] J 
y table [HEIGHT] ; 



nplanes; 

X, y^ color; 



/* Bitplanes allocated */ 
/* Pixels across screen 

(640 for hi-res) */ 
/* Non-interlaced screen */ 

/* Array of bitplane pointers 
/' Offset table (bytes) for 

beginning of each screen 

row */ 
/* No. bitplanes (DEPTH) */ 
/* Desired pixel position & 

color */ 



main 
{ 



Preliminary code here: 

1) ROM Kernel- Set up View, Viewport , 
RastPort, Bitplanes as in ROM Kernel 

manual . 

2) Intuition- Open Screen and Window. 



/* Store bitplane starting addresses for 
ROM Kernel approach */ 



for (i = 0; 
bp[i] 



i < DEPTH; i++) 
= RastPort->BitMap->PianesIil 



/* The equivalent code for Intuition approach */ 
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for (i = 0; i < DEPTH; i++} 

bp[i] = window- >RastPort->BitMap->Planes 111 ; 



nplanes 



DEPTH 



ytable[0] = 0; 

rowoffset = WIDTH / 8; 

for {i = 1; i < HEIGHT; i++) 

ytabie[il = ytableti-1] + rowoffset; 



* Call FastPix , 



SetDrawMode ( rp, JAMl ); 
FastPix ( X, y, color ); 



Listing Two 



LISTING 2: The FastPixO function 



(t ***** n 



*Program: FastPix . asm 

*Version: 1.0 

*Author: Scotc B. Steimnan, O.D. 

*Date: 27-May-88 

*Purpose; Faster general-purpose pixel-drawing 

* routine to replace ROM Kernel 

* writepixel(J routine, 

* Restrictions; 

* 1. This version for 32-bit integer programs. 

* 2. This version for non-interlaced screens 

* only- 

*Call from C: 

* void FastPlx( K, Y, color ) 

* short X, y, color; 

* Giobals {*** MUST BE SET UP PRIOR TO CALLING 

* FASTPIX ***} : 

* _bp Array of bitplane pointers 

* lUBYTE *bp[ DEPTH]) 

* _ytable Array of y-offsets 

* (short y table [HEIGHT J) 

* _nplanes Screen depth 

* (short nplanes) 



***********-* ************** ***************** 



Parameters: 

X X-position on screen 
y Y-position on screen 
color Color of pixel 

lr**************lt 



(2 bytes) 
(2 bytes) 
(2 bytes) 



t************ 



* Registers used: 

* d2 Pixel Bit within BitPlane Byte 

* d3 Index for BitPlane we're working on 

* a2 Pixel ByteOffset within BitPlane 
****************************************#******** 

*De3Cription; 

* The K- and y-positions of the pixel to be 

* drawn and its color are passed to FastPix 

* by means of the stack. 

* The program calculates an offset from the 

* start of each bitplane from y and the 

* ytable, a table of byte offsets for each 

* row of the screen. Next, a second offset is 



added for the x-position within the row by * 

dividing the x value by 8. The modulus of 

that division is the pixel bit number with- * 

in that byte. A loop is then entered in * 

which each bit of color is checked and the 

corresponding pixel bit for each bitplane 

is set or cleared. 

**«**************************^***-************ 

MACHINE MC68000 



y -> row offset 
Cast long -> array index 
Array offset for shorts 
ytable array base addr 
ByteOffset = ytable [y] 
X -> column byte offset 
Cast offset as long 
Div by 8 for CoiumnByte 
Add to ByteOffset 

X -> get pixel in byte 
Mask low 3 bits (x % 8) 
BitNumber = 7 - lo3bits 



CSEG 




XREF 


_FastPix 


_FastPix: 




itiove.w 


10(SPKdO 


ext . 1 


dO 


asl.l 


n,do 


lea 


_ytable,aO 


move.w 


{aO,d0.1),a 


move . w 


6(SP),dO 


ext-1 


dO 


asr.l 


#3,d0 


add.w 


dO, a 2 


niove . w 


6(SP),d2 


and.w 


#7,d2 


move . w 


f7,dO 


sub.w 


d2,d0 


move.w 


d0,d2 


ext.l 


d2 


move.w 


nplanes, d3 


ext . I 


d3 


pixloop 




move.w 


d3,d0 


ext.l 


dO 


asl.l 


#2,dO 


lea 


bp,aO 


move,w 


a2,dl 


ext.l 


dl 


move . i 


(aO,d0.1),a 


add.l 


dl,al 


checkcolor 




move.w 


14(SPJ,dO 


btst 


d3,d0 


bne 


setpixel 


clearpixel 




bclr 


d2, (al) 


dbf 


d3, pixloop 


rts 




setpixel 




bset 


d2, (al) 


dbf 


d3, pixloop 


rts 





Cast as long 

Initisliae PlaneCounter 
Cast as long 



Load PlaneCounter 
Cast as long for index 
Array offset for longs 
BitPlane ptr array base 
Get ByteOffset 
Cast as long 
1 Store BP [PlaneCounter] 
Add ByteOffset for PixAddr 



Load color 

Test plane- th color bit 

Set pix if 1, clear if 



Clr bit in PixAddr byte 
PlaneCountr >= 0, reloop 
Exit 



Set bit in PixAddr byte 
PlaneCountr >= Q, reloop 

Exit 



DSEG 
XDEF _nplanes,_ytable,_bp 

END 



•AC' 
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Populous 

■ The World Accordina to You! 



review by Miguel Mulet 

Have you ever dreamt of reaching 
heights beyond the world of mere 
mortal? Does the thought of having thou- 
sands of followers worshiping your every 
deed have any appeal? Do you want to 
have fun? If you answered "yes" to any of 
these questions, then Populous is the game 
for you. 

Populous is a new game written by 
an English software group called Bullfrog 
and distributed by Electronic Arts. This 
game is fantastic — probably 
the best game to be published 
in a long w^hOe. The premise is 
fairly simple: you become the 
divine influence over a tribe of 
humans. Your goal is to ma- 
nipulate nature in ways that 
will make your followers tlie 
dominant race on the world. 
This job, unfortunately, is not 
without its difficulties. You 
see, tiiere is also anotlier deity 
trying to accomplish the same 
thing, on the same world, at the 
same time. Of course, tliere is 
no room for both the followers 
of Good and the foUow^ers Evil 
on the same planet. Thus, your 
work is cut out for you. 

How do you accomplish 
your task? Your power, or 
"manna," is derived from the 
number of followers you have 
on the planeL To help the 
population to survdve and grow^, you flatten 
lands^ — ^which you can raise from die 
ocean — so that your followers may plant 
crops. (Isn't it great being a deity?) As ihe 
population grows, your followers build 
greater homes, and even castles. They also 
become stronger and more industrious. 
This allows them to venture further out on 
the land you have provided, where tliey 
form new setdements. 

Life is not so simple for your follow- 
ers, because the follow^ers of the other deity 
are also trying to accomplish the same 
thing. Since there is only a limited amount 
of land on tlie world, the two groups are 



bound to conflict — unless, of course, you 
exercise divine intervention. 

At first, your power is limited: all you 
can do is raise and lower land in a limited 
way. Your manna level is represented by 
a sliding scale in the upper right corner of 
your screen. As your manna strengdiens, 
you can then place a "Papal xMagnet,"" This 
magnet is used to lure your foilow^ers — or 
"walkers," as the game refers to Uiem — to 
new lands. Once you have acquired this 




This rather unfriendly looking gentleman is one of the Evil 
representatives against whom you will battle in Populous, 



ability and continue to grow stronger, you 
gain the ability to ravage earthquakes on 
the unsuspecting enemy. You can also 
create swamps, volcanoes, and even 
floods, which will decimate the enemies 
lands. 

As a deity, you also have the ability to 
create knights, whose sole purpose is to 
fight with the enemy and destroy their 
homes. The ultimate power is to declare 
Ajmageddon, w^hich forces the world into 
one final battle to determine who shall rule 
it. Remember, however, that your oppo- 
nent may be able to do the same things to 
your people. 



The game is played on a single screen 
divided into several areas. In tlie upper left 
comer of tlie screen is the "Book of 
Worlds/' which is an overhead view^ of the 
world you are fighting for. On this map, 
white dots represent tlie colonies of the 
Good followers, while black dots represent 
Evil colonies. Blue dots represent Good 
walkers, while red dots represent Evil 
walkers. By moving your cursor on this 
map and pressing tlie left mouse button, 
you can get a close-up view of 
that part of the w^odd. 

The majority of the 
screen is occupied by the 
"Close-up Map," which 
shows you the world terrain, 
colonies, and walkers. When 
you move/place your Papal 
Magnet, it appears on diis 
screen. You can move 
around on the closeup map 
by pressing die directional 
arrow^s in the lower left comer 
of the screen with the left 
mouse button, (You can also 
use the keyboard keys, but 
input is slower. I found it 
easier to use the mouse and 
the directional keys on the 
screen,) Surrounding the 
directional keys are the com- 
mand keys, which allow you 
to perform your divine duties. 
At your disposal is a 
small shield that you can use to "tag" 
friendly or enemy establishments or 
people. When something is tagged, the 
information on that item is represented in 
tlie 'Information Shield," which is in die 
upper right corner of the screen. Tliis 
shield is divided into four sections, which 
represent whether the tagged item is good 
or evil, how strong it is, and how^ developed 
it is. In combat, the shield also shows tlie 
strength of the t^'o combatants. To the left 
and right of the shield are t^^o bans — one 
which shows the Good population, the 
other the Evil population. The higher the 
bar, the greater the strength of that popu- 
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lation. The ^'health" of your population is 
represented by a steady heartbeat emanat- 
ing from your speakers. The lower the 
heart rate, the stronger you are. 

Ail this may sound complicated, but 
it is ver>^ easy to get the hang of. The 31- 
page manual is well written and easy to 
understand. There is even a tutorial mode, 
which shows you the basics of the game in 
about 15 minutes. As a matter of fact, the 
first few worlds are fairly easy to conquer. 
The challenge is tliat each of the 500 levels 
in tills game can feamre different terrains 
(grassy, volcanic, icy, or desert), all of 
which effect how fast the population grows 
and the strategy you use to win that level. 
As if that weren't enough, your opponent's 
population grows faster as the game pro- 
gresses, and it also becomes more aggres- 
sive. Thus, this game does involve creating 
and altering strategies to fit each individual 
world. 

The people at Bullfrog have done an 
excellent job of programming Populous. 
The graphics are very well done, and the 
soundtrack is excellent throughou t. (If you 
go directly to the game on startup, you'll 
miss the excellent introduction Uiat plays 
before the game.) .-^ though the soundtrack 
may be repetitive to some, I think it adds a 
lot of ambiance to the game. The program- 
mers have added two icons in the lower 
right corner of the screen which allow you 
to turn off either tlie heartbeat and/or the 
soundtrack. Also included is a much 
needed pause key. 




If you get tired of nice grassy worldsj try helping the 
followers on this icy planet! 



Along with all this possible variation, 
tlie programmers have included tliree 
additional features. One is the **Scales" 
icon, which allows you to change which 
powers are available to either Good orEviL 
(That way, you can even tilings out if one 
liuman opponent is more experienced than 
anodien) Below tliis icon is a "World" icon, 
which allows you to change the parameters 
of the world you're playing in. You can 
make swamps bottomless, or disappear if 
only one person falls in. You can also load 
and save previous games. This screen also 
allows you to customize worlds; you can 
decide on the terrain, how many and where 




The world of Populous, The upper left comer 
shows the Book of Worlds, tvhile the Closeup Map 

is shown in the middle, Tlie upper right corner 
shoivs the Manna Bar and the Infonnalion Shield, 
The lower left comer shows the command icons* 



the initial followers will be placed, etc. It's 
basically a "Populous Constmction Set." 
Lastly, the game can be played over a 
modem or through a direct datalink be- 
tu^een Da'O Amigas. 

However, notliing is perfect — not 
even in Populous. Unfortunately, there is 
no provision for iwo pla>' ers to play on the 
same computer at tlie same time, but this 
may be due more to the logistics of game 
play than to an oversight. Lastly., keyboard 
input on tlie selection screens is very^ slug- 
gish. You'll have to ry^pe slowly if you want 
to enter sometliing correctly tlie first time. 
Don't let diese problems s^^ay you ; they are 
minor inconveniences, at worst! 

This game is great! It imolves a lot of 
strateg>% yet remains extremely entertain- 
ing. (Beware: It is also ver)^ addictive, and 
may ruin the rest of your life!) There are 
plenty of levels (if you call 500 plentv'), and 
although tlie earlier ones are fairly easy to 
win, the later ones do get more challeng- 
ing. The graphics are well done, as is the 
soundtrack. As I said earlier, tliis is one of 
the best (if not the best) games I have 
played this year. Populous is well wortli 
your hard-earned dollars. Bravo to Bull- 
frog! If diey keep this up, I'll never get any 
work done! 

•AC* 



Populous 
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review by Phil Saunders 



When I was a boy, I used to read 
about the naval battles of World War 11. My 
friends and I would create drawings of the 
Battle of Midway and imagine what it 
would be like to fly in a dive bomber. With 
BattieHawks 1942 from LucasFilm Games, 
I no longer have to wonder. BattieHawks 
1942 is both an arcade game and a simula- 
tion. It puts you in ihe cockpit for four 
crucial battles that helped decide the out- 
come of World War II in tlie Pacific. You 
recreate tlie actual combat missions that 
American and Japanese pilots flew. 

Tliere are four types of missions 
included in BattieHawks: Fighter Intercept, 
Fighter Escon, Dive Bombing, and Tor- 
pedo Bombing. Each played a vital role in 
the naval campaign of WWII. By recreating 
these missions, BatdeHawks gives you a 
taste of what it was like to fight during 



World War II, when the outcome of the war 

depended on the skOIs of a few brave 
pilots. 

The first thing you notice about Bat- 
tieHawks 1942 is the manual. Baltlehawks 
has the best manual 1 have ever seen for a 
game; it's better than the documentation on 
most applications soft^^are. Tlie 130-page 
manual is divided into four parts: Introduc- 
tion, Historical Overview, Game Flay, and 
Reference Information. 

The Introduction contains a brief 
preface from Lieutenant Commander Rich- 
ard Best, a WWII Navy pilot who sensed as 
technical advisor for BatdeHawks 1942. 
The Historical Overview describes the 
importance of the four battles reenacted in 
this game; the Battle of the Coral Sea, the 
Battle of Midway, the Battle of tlie Eastern 
Solomons, and the Battle of the Santa Cruz 




BattieHawks 1942: the view from the cockpiL 



Islands. This section includes numerous 
photos, illustrations, and quotes from par- 
ticipants on both sides. Its layout is well 
designed, and some of the quotes are 
actually quite hinny! The details in the 
Historical Ovemew provide a real sense of 
"being tliere", which most games lack. 

The Game Play section of the manual 
describes the operation of the game, while 
a separate Amiga Reference Card gives 
loading information. Screen dumps, pho- 
tos, and illustrations provide details on 
how die controls work. The Game Play 
section also describes the combat missions 
that can be flown in BattieHawks 1942. The 
Reference Section provides information 
about flight fundamentals, combat tactics, 
and the planes and ships involved in the 
battles. It also provides color maps diat 
trace the events that actually occurred in 
each battle. 

When you boot BattieHawks you are 
presented with an introductory screen, a 
list of credits, and then the main menu. The 
menu offers several options. Select Train- 
ing and Select Active Duty allow you to fly 
the training and combat missions, respec- 
tively. Review Planes allows you to view 
each plane used in the 1942 batties. It gives 
a brief description and rough picture of 
each plane. I was a bit disappointed by the 
graphics, which fail to include much detail. 
However, one nice option allows you to 
rotate each plane so you can view it from 
various angles. This part of the Review 
Planes option complements the manual's 
more detailed descriptions. 

The Review Service Records option 
lets you keep track of your pilots. To fly 
active dut>^ missions, you must first format 
a blank disk, label it "BHPilots," and then 
select ''Prepare Disk" from the Ser\dce 
Records menu. It would be nice if the game 
would handle these details for you. I had 
some trouble widi tlie game prompting me 
for the BH Pilots disk when it was already in 
drive 0. Ejecting the disk and then reinsert- 
ing it usually solved the problem. The 
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Review Sendee Records menu has com- 
mands for managing your pilot files, and it 
can also select an honor roil of the best 
pilots on both sides. 

Training iMissions allow you to prac- 
tice tlie skills needed for each type of mis- 
sion, while Combat Missions require you to 
risk your pilot's life in a combat environ- 
ment. Once you have selected a 
mission, you proceed to tlie 
Ready Room, where you are 
briefed on what you need to do. 
In BattieHawks 1942 (as in the 
real Navy) the emphasis is on 
accomplishing the mission. If 
you are flying escort, it doesn't 
matter how many planes you 
shoot down. Your mission is to 
protect the other aircraft; if they 
are destroyed, you have failed, 
BattieHawks scores you based 
on how many missions you suc- 
cessfully complete. 

The Ready Room also al- 
lows you to modify the parame- 
ters of each mission. The de- 
faults simulate tlie actual combat mission, 
but you can easily edit tlie details. Could 
Japanese Zeroes have stopped the Ameri- 
can bombers at Midway if tliey had been 
flying at higher altitudes? Would better 
fighters have saved the Lexington in die 
Battle of the Coral Sea? Just change the 
parameters of the missions and fmd out! Of 
course, if you modify the missions to make 
them easier, they will not count for your 
active duty statistics. 

Once you have selected a mission 
and modified its parameters, select Begin 
Flight to start your mission. Flere copy- 
protection rears its ugly head. You can 
back up your BattieHawks 1942 disks, but 
you must enter a codeword before each 
new mission. BattieHawks will flash the 
silhouette of a Japanese flghter on the 
screen and prompt you for the correspond- 
ing codeword in the manual. You dien 
search die lower right-hand comers of the 
pages, find the right plane, and enter tlie 
codeword. This is a clever way to perform 
the verification; it mimics die aircrew train- 
ing used by combat pilots. Nevertheless, it 
would have been better if the program gave 
you the page number diat tlie silhouette 
was on — and better still if the program did 
not repeat die process for eacli new mis- 
sion. Despite diis complaint, BatdeHawks 
1942's codeword protection is less objec- 
tionable than other kinds. 

Unlike Electronic Arts' F18 Intercep- 
tor, BattieHawks does not let you take off 



BattieHawks gives 

you a taste of what it 
was like to fight dur- 
ing World War II 
wbe?t the outcome of 
the war depended on 
the skills of a few 
brave pilots. 



and land your plane. Instead, it places you 
directly at the scene of the combat and lets 
you take control. Someone familiar with 
the F18 Interceptor will find BatdeHawks 
quite different. World War II planes did not 
have die thrust of modern jet engines, so 
some Interceptor moves simply will not 
work. The planes move more slowly; if you 

try to climb 
too rapidly, 
the aircraft 
will stall. If 
this hap- 
pens, tlie air- 
craft's nose 
will drop 
and it will 
start to dive. 
You must 
then pull 
back on the 
stick again 
to recover. 
This feels a 
litde unreal- 
istiCj espe- 
cially since you must fly BatdeHawks with 
a mouse instead of a joysdck. Despite diis 
quirk, die airplanes handle relatively well. 
You can make die plane dive, climb, and 
bank (diere is no control of the mdder). 
Nevertheless, response to the controls is 
good, but a bit more gradual than in F18 In- 
terceptor. 

Aii*-to-air combat in Batdehawks is 
quite different from its equivalent in FIS 
Interceptor You have no radar to locate 
enemy planes, so you must constandy 
check around you. If you forget to '* check 
your six" (look beliind you) you may soon 
see an enemy fighter's bullets going into 
your airplane. You can change viewpoints 
by using the numeric keypad to turn your 
head. There is also a ''scan mode" which 
allows you to change your viewing angle 
with the mouse. Once you have located die 
enemy planes, you must maneuver into 
position to attack them. You cannoi simply 
fire an air-to-air missile; instead you must 
lead tlie enemy planes so that your bullets 
strike the target. This is quite challenging, 
because the amount of lead angle changes 
according to your approach. Formnateiy 
planes flew slower in World War II, so you 
have more time to react. The air-to-air 
combat segments of BatdeHawks 1942 are 
quite realistic and challenging. 

The other missions are equally w^eU- 
done. A successful dive bombing run re- 
quires a high-altitude approach. You must 
ward off enemy fighters with your tail guns 



until you approach the target, and then 
dive direcdy into the teeth of die enemy 
carrier's anti-aircraft guns. You can do 
some maneuvering to avoid tiieir fire, but 
you must put your bomb on target to 
complete the mission. I was fairly success- 
ful in the training mode, but with enemy 
fighters on your tail it is much more diffi- 
cult! The torpedo bombing mission is even 
harder. You must take the plane in low and 
slow to be successful, but this type of 
approacli makes you vulnerable to enemy 
fighters. This mission was quite dangerous 
in World War II: a U.S. torpedo bombing 
squadron lost all its planes during an attack 
in die Battle of Midway. 

The graphics in BatdeHawks are not 
quite up to die standard that F18 Intercep- 
tor has set, but diey are still quite good. One 
great feature is the ability to record parts of 
your mission using a flight camera. When 
you replay diese portions, you can change 
camera angle, altitude, and position to get 
a bird's eye view of ±e fight. This option 
lets you evaluate die effectiveness of your 
tactics and allows for the necessary correc- 
tions on your next mission. The routines 
that guide die enemy planes are quite 
good, so you need to think constandy to be 
successful. 

As you can probably tell, I like Bat- 
deHawks 1942 a lot. It succeeds both as a 
game and as a simulation, which is quite 
rare. The manual is superb; it really puts 
you into the spirit of the game. My only 
complaint is that the success of a mission 
does not carry over into the other scenar- 
ios. In otlier words, if you sink a carrier on 
one mission, it may still show up on a later 
mission. This is due to die accuracy with 
which BatdeHawks 1942 recreates each 
batde, but it would be interesting to see a 
game in which your actions could alter the 
strategic aspects of a war. Despite this 
quibble, I recommend BatdeHawks 1942 if 
you like flying, combat games, or have an 
interest in World War II. It is an extremely 
ambitious and successful effort. 

Battlehawks 1942 wUl am on 512K 
systems, but one megabyte is recom- 
mended. The game uses manual copy- 
protection. -AC- 
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flmiga Circuits 

Hardware Access To Your Amiga 



by John lovine 

Amiga computers are sophisticated 

and advanced machines, but it is possible 
to furtlicT enhance and utilize its abilities 
by learning to interface personal hardware 
projects to the various I/O ports on the 
machine. By programming and controlling 
the interface tlie user will become directly 
involved in using and understanding tlie 
Amiga's internal I/O (input/output) chips, 
while beginning to realize the full potential 
of the machine. 

Basically^ connecting a computer to 
an external device or circuit is known as 
interfacing. Interfacing is the exchange of 
data between a computer and an external 
device J circuit or another computer, as well 
as controlling an external device by com- 
puter. Applications range from controlling 
appliances and electronic devices to com- 
puter security systems, robotics and bio- 
feedback devices. The computer can also 
track and/or react to Sight, sound, temj>era- 
rure, pressure, \abration or any otlier 
measurable parameter. Applications are 
limited only by the imagination. 

Although die Amiga has a number of 
ports for interfacing, the parallel port is all 
that will be discussed tliis montli. 

8520 Chip 

The parallel port on the Amiga is 
controlled by the 8520 PIA chip. This IC 
(integrated circuit) is connected bet^s'een 
die 68000 CPU (Central Processing Unit) 
and the I/O port5. j\\{ input and output 
fiinaions are transmitted by tlie 8520 chip 
to die CPU. Each 8520 chip contains tw-o 
parallel eight-bit I/O pons, two 1 6-bit 
counter/timers, a clock and a serial shift 
register. The Amiga contains two 8520 
chips. Timers, intermpt routines and 
serialized data will be examined later on in 
the series, but for now the lesson will begin 
by using one 8-bit parallel I/O port that is 
connected to tlie external parallel port. 



PXJEASENOTE: 

This project may void your warranty and 
is offered for the enjoyment of the 
technically inclined. PiM Publications, 
Inc. is not responsible for any damages 
incurred while attempting this hardware 
project. 



All access to the parallel port is 
accomplished through the 8520 VIA chip. 
In order to access die chip, it is necessary 
to read and set various bits on the chip 
registers. This isn't as difficult as it may 
sound, but it does require a basic 
understanding of the binary number sys- 
tem. 

Binary 

Binar)' means 'based on two" (as in 

xwo numbers - and 1). In binarv^ a digit 
is called a bit, which stands for binarv^ digit. 
A bit has a value of or 1, just as a light bulb 
has a value of off (0) or on (1), A byte is a 
digital expression containing eight bits. A 
w^ord contains 2 bytes (l6 bits) and a long 
word contains 4 bytes (32 bits). The 68000 
microprocessor is a 16/32 bit processor. 
The expression 16/32 is used, because the 
microprocessor has 16 bit data bus lines, 
and 32 bit internal registers. 

All the information can be extrapo- 
lated to 16 and 32 bits, but for now it ^'ill 
be in 8-bit bytes. In addition, the informa- 
tion is valid for controlling other chips 
inside the Amiga computer. Since this ar- 
ticle is on interfacing the parallel pon, an 
investigation of the binary relationship for 
controlling various I/O functions is due. 
Look at Table One. For each progression of 
die binary 1 to the left, tlie powder of t^^o is 
increased by 1 . These are relevant numbers 
because each progression identifies a bit 
location and weight. Notice die correlation 
between the parallel port and the bit weight 
table; diis will be used often. Table One 
demonstrates binar)' counting dim 20. 

When a bit \n the port is configured 
for input, die computer uses electrical 
voltages present at the pin/liit location to 
detemiine whether the bit is set oni\) or off 
(0). A voltage level between 2 and 5 volts 



will set the pin to a binary 1 (on). When a 

voltage level between and 0.8 volts is 
received a binar\^ is assigned to the pin. 
Voltages betu^een 0.8 and 2 volts are unde- 
fined. 

When a bit in the port is configured 
as output, the computer will output {'wc 
volts when a binarv' 1 (on) is placed at the 
pLn/bit location or zero volts wlien a binary' 
(off) is placed at the pin/bit location. 

DDR 

The DDR (Data Direaion Register) is 
a programmable register on the 8250 chip 
that controls tlie direction (input or output) 
of the bits in the port . The DDR is nienior>' 
mapped at location 12575489. This means 
the register can be accessed by using that 
memory location in Amiga Basic with 
simple PEEKS and POKES, A binary 1 
placed at a bit location will turn tliat bit into 
an output bit. Conversely, a binary^ will 
make that bit an input bit. Bit weights 
(Figure One) are used to output btnarv^ Vs 
at the corresponding pins to create output 
pins. Any pins diat aren't programmed as 
outputs automatically have O's placed at 
dieir bit locations and are therefore config- 
ured as input pins (Table Two). 
"POKE(1275489),20'* would turn PB2 and 
PB4 into output bits, as PBO, FBI, PB3, PB5, 
PB6 and PB7 automatically become input 
bits. 

To see this more cleariy, transfer the 
binary equivalent of 20 (from Table One) 
into the empt>^ register location spaces on 
Figure One. The binar>^ i's are in the PB2 
and PB4 bit locations. 

"POKE(1275489).3" makes PBO and 
PBl output bits, ti'ansfering the binary 
equivalent of 3 into the location spaces. 
See how die number 3 (in binar\0 places 
rs at the location of PBO and PBl? As can 



Parts List 



Quan. Item 



Manufacturer Part Number 



1 Breadlx)ard 

B Submiiiiature LED's 

1 DB 25 Pin Male 

Misc. 22 gauge wire 



Radio-Shack 
Radio-Shack 
Radio-Shack 



276-175 or 276-174 

276-0268 

276-1547 
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be seen by POKEing this location with vari- 
ous bit weights, any pin in the port can be 
configured to be an input or output bit in 
any combination that might be required. 
Any unused bits can be ignored. 

To summarize, POKEing a binar)^ 1 in 
the DDR corresponding to a bit airns that 
bit into an output bit. Conversely, POKEing 
a binary wil! rum tlie bit into an input bit. 

Data Register 

After the port has been configured 
witli the DDR, it can be used to output or 
input information. The Data Register is 
where your data actually resides. The Data 
Register memory location is 12574977, It is 
possible to use simple PEEKs and POKEs in 
this memory location to input or pull data 
off the pins. The procedure is similar to the 
one described for tlie DDR. This will be ex- 
plained in greater detail after the demon- 
stration interface circuit has been built. 

Input 

Examine the diagram of the parallel 
port again. Beneath the port are labels PBO, 
PBl, PB2,etc. , corresponding to the pins on 
the parallel pon. Under that are tlie corre- 
sponding bit weights for each pin. Let's 
configure all the bits on the port as inputs. 
From AmigaBasic the command 
TOKE(12575489),0'' POKEs the DDR with 
binary O's at all bit locations. Now apply +5 
volts to pms PB2 and PB4. By applying the 
5 volts to these pins a binary 1 is placed at 
each pin. 

By peeking tlie port with "PRINT 
PEEKd 2574977)" die number 20 would be 
returned. This is the added bit w-eights ( 4 
+ 16 = 20 ) of pins PB2 *f PB4. Look atTable 
One. Transfer the binary equivalent of the 
number 20 into die bit locations on Figure 
One and it is the same. Notice diat the 
binary I's are in the same bit locations 
where tlie 5 volts were inputted. If +5 volts 
were applied to PB5 only, and die port was 
peeked, the number 32 would be returned. 
This is taie for all pin/bit combinations. 

Ouq>ut 

Reconfigure the parallel port so Uiat 
all the bits are now outputs; 

POKE(12575489),255 

This command places binary I's at al! bit 
locations. Now poke the number 20 into 
the port 

POKE(12574977),20 

+5 volts will now appear in PB2 and PB4. 



By poking the 
number 20 into the 
port, a binary 1 is 
outputted at those 
two pins. It is 
important to 

understand that the 
voltage being 
outputted is a 
signal voltage, and 
has very little 
power. Therefore, 
it cannot be used to 
drive a device by 
itself But by 
adding a very 
simple circuit 
(described later), it 
is possible to use 
the signal to control 
almost any elecixical appliance. 



Circii it Constrn ction 

Look at Figure Two. This is a simple 
circuit that doesn't require much soldering. 
Most of the soldering has been eliminated 
by using an experimenter's plug-in bread 
board. By using this board the components 
and control lines can simply be plugged in. 
This facilitates changing the circuit when 
necessary. 

The proto-t}'ping breadboard is sold- 
erless and 22-gauge wire is used to connect 
tlie components on the board. For those 
individuals who have never used a proto- 
t>^ping breadboard, the holes on the board 
are plug points. The plug points are inter- 
nally wired as shown in Figure Three. The 
column points on each half are connected 
as shown, as are the rows on each half The 
rows are usually used as power supply con- 
nections, one being ground the odier tiie 
positive voltage supply. All die parts re- 
quired can be ac- 
quired at Radio 
Shack, 

Take care in 
making solder con- 
nections to the DB 25 
pin male. Notice diat 
in addition to solder- 
ing wires to the port 
pins, leads have also 
been run from an 
additional ground 
pin and the +5 volt 
pin. These lines will 
be useful later. Do 
not use or substiaite 
other LEDs for the 
ones called for on the 
parts list. These LEDs 



Below: A bread board ivitb LED's, Dip Switch and a 
DB25 that connects to the parallel port of the Amiga. 




were chosen because there are micro- 
miniature and don't require much power. 
Because of tills, Uiey can be powered 
direcdy from the current available at die 
port pins. When the soldering has been 
completed and the circuit has been wired 
as shown, we are ready to continue. Turn 
off the computer (if it is on) and plug the 
male connector into the parallel printer 
port. Remove tlie printer cable (if there is 
one) and replace it with the interface. 
Power up the computer. Ail the LEDs 
should be dimly lit. If they are not, airn off 
the computer immediately because a wir- 
ing error has been made. Recheck the 
wiring and make sure the LEDs are installed 
properly, widi the correct polar it)'. The rea- 
son the LEDs are dimly lit is that altlioiigh 
the computer configured all the bits as 
inputs on power up, the 8520 chip pulls the 
bits to five volts through a pull up resistor. 
There is sufflcieni: current to just dimly light 
die LEDs. 





TABLE ONE 




~~ 
















1 




Decimal 


Binary 


Decimal 


Bin an' 

- 00001011 
= 00001100 
= 00001101 
= 00001110 





1 

2 = 

3 = 


00000000 
00000001 
00000010 
00000011 








11 

1 7 












13 
14 
15 
16 
18 
19 
20 

255 




5 ^ 


00000101 










= 00010000 I; 




6 = 

7 

8 

9 = 


00000110 
00000111 
00001000 
00001001 








- 00010001 

- 00010010 
= 00010011 

= 11111111 
= iiiniii 
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FIGURE TWO 
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FIGURE ONE 
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PHOTO-TVPING BREAOeOARD 



If everything checks out, load 
Amiga Basic into the s>^stem and enter: 

POKE (1 2575489),255 (This command sets 
up the DDR and turns all bits into output 
bits.) 

POKE (12574977),20 (DR Data Requister. 
This command lights LEDs connected to 
PB2 and PB4,) 

POKE (1 2574977),0 (Turns off LEDs) 

In order to become familiar witli bit 
weights and their correlation to the pins, 
type in this simple program. Any number 
inputted (0-255) will lite the LEDs 
corresponding to their bit weights and 
binary number representation. 

Setup; 

DDR= 12575489& 

DR - 12574977& 

POKE(DDR),255 

Start: 

IINPUT'Emer number - 255)"; BW 

PRINTThe number "BW" is being 



displayed in binar^^ on your interface" 

POKE(DR)3W 

GOTO Start 

This second program will count in binary. 

To make it run faster or slower, decrease or 
increase the value of T in the program. 



Setup: 

DDR = 12575489& 

DR = 12574977& 

Poke(DDR),255 

Stan: 

For X = to 255 

Poke(DR),x for t = 



1 to 500 : next t 



Allow me to make one final 
suggestion. Our interface is to the parallel 
port that is also used for printers. Cable 
switching; removing tiie printer cable and 
hooking up our interface can become a 
major hassle real fast. Especially when 
going back and forth often. However, there 
is a way to eliminate this hassle, by usinga 
data transfer switch. A data transfer switch 
will connect to the amiga port and give you 
two selectable ports, A or B. By connecting 



your printer to one and interfacing projects 
to another will allow you to sxvitch to and 
from the printer and interface. 

Next Month 

Next month we will continue 
experimenting with this interface. We ^\dll 
examine inputting binary^ information, bit 
manipulation and a few more interesting 
basic programs. I advise not skipping this 
project, because although it is simple to 
construct and you MAY have a handle on 
the information, without building the 
interface the information gained witliout 
experience is sterile and easy to forget. By 
building the project you get your feet wet 
witli construction techniques required for 
more advanced projects, like soldering and 
using the proto-typing board. The binary 
information will also help immensely when 
we go on to more advanced interfacing 
projects. 

The Data transfer switch will be 
reviewed again next month, and vendor 
information will be available. 

*AC- 
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Ami-XlO Software 

Software to program the X- 10 Home Control Interface with your Amiga 

by Mike Morrison 



Hot coffee at 6:30am. The stereo 
turned on at 7ain when I get out of the 
shower, and off at 7:30am when I leave for 
work. The outside porch lights turned on at 
dusk, dimmed at midnight, and shut off at 
dawn. Two other lamps inside turned on 
and off at random times at night. 

A trusty buder you ask? No buderhere. 
It's Ami-XlO Home Control Interface 
Soft^'are by Digital Dynamics. When used 
in conjunction with a X-10 Home Control 
Interface (available at most electronic 
hobby stores) the above is only tlie 
begining of how you can automate your 
home. 

The Hardware 

The X-10 Home Control Interface is a 
stand alone controller that uses existing 
house wiring to transmit control signals to 



receiver modules plugged into power 
oudets. The interface operates by itself 
once you program it with your Amiga. 
There are two basic types of control 
modules - appliance and lamp. Lamp 
modules can be turned on, off, or dimmed. 
Appliance modules can either be turned on 
or off. Each module can have a code from 
one to 256. You could have several 
modules with die same code so they would 
be turned on at the same time (ie. front and 
back porch light). 

The Software 

The Ami-XlO software gives you 
complete flexibility in programming tlie X- 
10 Home Control Interface. The package 
comes with one disk (not copy protected), 
and a nicely done manual. The disk 
contains several programs to help make it 




Ami-XlO gives you fuli control over the XI Home 
Control Interface with its main uHndow. 



easy for you to program the controller. 
Setsys is a small program that lets you sec 
the system time and date from the 
Workbench. Cities is a small h\e that 
contains the latitude, longitude, and other 
infomiation used to calculate sunrise and 
sunset. There is a default parameter file, a 
schedule file, and a ReadMe file to get you 
started. Included on the disk is a CLI 
runnable program tliat can be put into your 
startup-sequence to send commands to the 
controller. 

Ami-Xl Program 

This is tlie program that ties it all 
together. When you double-click on it's 
icon tlie program starts and opens a 
window. On the right side is an area that 
lists all the the house and module codes 
widi a description of what tliat module 
controls. House codes can be from A-P and 
moudle codes can be from 1 to 16. The 
house codes can be changed so that if you 
have close neighbors who also use an X-10 
you won't be turning their lights and 
appliances on and offl The module code is 
unique to a specific module. If your house 
code was set to 'C and the light in die 
basement was on module 7 the code would 
be C7. And you could put 'basement light' 
in the description area. 

On the upper left side of the screen 
there are three gadgets marked: all, 
appliances, and lights. These will select the 
appropriate type modules that are 
displayed on the right side of the screen. 
Next to them are three more gadgets, off, 
on, and dim. The off and on gadgets do just 
as they say to the seleaed modules. The 
dim gadget works in conjunction with the 
slider gadget to it's right. The slider gadget 
has l6 positions and allows you to dim 
lights that are connected to dimmer type 
modules. To the right of these are yet 
anotlier set of three gadgets. These consist 
of a clock, two left and right arrows, and a 
gadget with a lightning bolt on it. The clock 
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Omnitek Computers 

AMIGA 




FULLY AUTHORIZED 

SALES AND SERVICE 

FOR ALL COMMODORE 

PRODUCTS 




SOFTWARE 
20 



CLEARANCE 
- 75% OFF 



SALE 




1300 Main St, 
Tewksbury, MA 01876 
(508)851-4580 



We carry a complete line of softwa/e 

and accessories for the AMIGA, 
Come to ouf Salem, NH location and 

pay NO SALES TAXI 78 Main St, 

Salem, NH 03079 

(603)893-9791 



circle 136 on Reader Service card. 



shows eidier the currenl time, or the time 
that a certain module event will take place. 
The arrow keys allow you to increment or 
decrement different typ>es of infomiation in 
conjunction with other gadgets (ie. adjust 
the clock, page through module 
information, display a different page of 
house codes). The lightning bolt will 
activate immediate mode. /Vny commands 
executed with this gadget down will 
happen immediately and won't be stored in 
the X-10 controller. 



The lower-left half* of the screen has 
gadgets and information that help you edit 
when each module is turned on and off* as 
well as displaying some relevant 
information. There are three gadgets 
labeled tomorrow, today, and week. 
Tomorrow and today will tell tlie controller 
to turn on the selected module at the time 
selected either today or tomorrow only. 
Selecting the week gadget brings up a set 
of gadgets with the days of the week on 
them. You can then individuallv select the 



«-«• \ Malt. 



M-XU 



fraskM 



Uieist»JA.)dl» 



Citits iew.XlltcM iem 



This is the ivindow that comas up when you dotihle-click ibeAmi-XIO 
disk icon. The window shoius the icons for the X- 10 program, and 

several utilities including SetSys, Cities, and a demo X 10 schedule. 



days you would like the selected module to 
be either turned on or off. There are two 
other gadgets marked normal and security. 
If you click the security gadget the selected 
module will be turned off and on randomly 
within a specified time period. This allows 
you to program a lamp to look as if it is 
being turned on, off, or even dimmed by a 
person. 

In addition to all the above mentioned 
gadgets there are several bits of 
information displayed also. There are two 
displays that show the current sunrise and 
sunset times. The program atoniatically 
calculates thi.s for you if you type in the 
longitude and latitude for your location. 
The major cities in die US and Canada are 
listed in a file on the disk. This ^^'ill help 
insure tliat if you have a light (or any other 
module) that you want mmed on, off, or 
dimmed at sunset and/or sunrise it will 
actually do its assigned duty at 
approximately the right time. 

There are also some cute icons tliat are 
displayed to show tliat certain options are 
selected. Once the X-10 controller is 
recognized by the program as being acti\''e 
a small X-10 icon is displayed. If tlie rain/ 
shine option is selected from the menu 
then the appropriate cloud/sun icon is 
displayed. If immediate mode is selected 
tlien a lighming bolt icon is displayed. 

The Ami-XlO program is highly 
polished. The program is ver^^ complete 
and looks ver>^ professional. The author 
has gone to great lengths to ensure that you 
can easily take advantage of all aspects of 
the X-10 controller. Ever^tliing from 
sprinklers, security mode, load/save 
settings, to tlie shadowed gadgets and 
complete manual lead me to highly 
recommend this software package to 
anyone with a desire to automate iheir 
home, 

•AC- 



Am f-X 10 Software only: $59,50 

AmI-X 10 Software 

8c 

X- 10 Controller: $124.30 

Diglfol Dynamics 

739 Navy Street 

Santa Monica CA 90405 

(213)396-9771 
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Spirit Technology's 



HDA-506 



by Chuck Raudonis 

Spirit Technology has just released a 
new device that enables Amiga users to tap 
into the large base of inexpensive and very 
reliable disk storage tliat exists for die PC 
market. Until now^ if you wanted to attach 
a hard disk to your system and you really 
didn't want to get into a scenario where you 
were building an interface yourself, you 
had to purchase an Amiga disk controller 
and a drive. This was an expensive option 
as these controller packages were costly. 
Spirit Technology has just changed all of 
tiiat. 

The HDA-506 is an interface that 
attaches to your Amiga and allows you to 
plug in any IBM compatible ST-506 half 
card disk controller. For those of you who 
are not familiar with these devices, they can 
be quite inexpensive and very reliable. 
Each ST-506 controller can control one or 
two IBM style hard disks. Drive sizes of 40 
MB and up are available at very reasonable 
prices. 

The Spirit HDA-506 is an ingenious 
design. The device consists of one printed 
circuit board tliat passes tlie bus tlirough, 
and an Amiga beige colored case. The 
board takes all of its signals from the main 
Amiga bus. It gets power from the hard disk 
power supply. Since tlie original Amiga 
power supplies were not powerhouses, 
this is a good design feature. Mounted on 
the board is an IBM st^de socket. This main 
board is attached to tlie Amiga bus and the 
IBM style controller is plugged into the 
HDA-506. 

Installation is quite simple. The IBM 
style controller is plugged into the HDA- 
506 board. A "Y" adaptor is attached to the 
power supply cable in your hard disk 
cabinet. One end of the "Y" is attached to 
the hard disk and the otlier is plugged into 



a similar jack on the HDA-506 board. This 
powers the board and the controller. The 
tw^o disk drive cables are attached to the 
conti-oUer (tliree cables if you are using two 
drives) and all the screws are reinserted in 
the cabinets and tightened up. Hardware 
installation is complete! 



With the current low prices 

for ST-506 drives and 

controllers, this product 

certainly deserves a look. 



spirit supplies a diskette that includes 
the device driver that is needed to run the 
ST-506 controller and complete instruc- 
tions for configuring the drive(s) for your 
system. Also on tlie diskette is a low level 
formatter that will initialize your disk. This 
program is well written and very easy to 
use. The program incorporates a Hiil Intui- 
tion interface. A 20 MB drive takes just 
minutes to low level format. Once the drive 
is low level formatted, the Amiga can get to 
die drive and utilize it. For the operating 
system to recognize tlie drive, it must be 
mounted. To accomplish this, a new device 
is added to the Mountlist file and then tlie 
AmigaDOS Mount command is issued. 
Spirit supplies a device entry that corre- 
sponds to a 20 MB disk. If your drive is a 
different size, minor changes will have to 
be made and then the device entry is 
copied into the MountList. Spirit docu- 
ments the entire process for you, so any 
needed changes are easily made without 
having to know anything about what is 
going on behind the scenes. 



Once die device is mounted, before 
it can be used by AmigaDOS, it must be 
formatted using die AmigaDOS FORMAT 
command. This will allocate the disk staic- 
lures and set up the drive for Amiga files. 
Formatting the hard disk is like formatting 
any Amiga diskette except tliat it is just a 
longer process as there are many more 
cylinders to initialize. After the drive is 
formatted, you can copy the operating 
system onto the drive and you are ready to 

go- 

The device driver that is included 
with the hardware is fully compatible with 
the new FFS in release 1.3, so this device 
will take advantage of the tremendous 
increases in speed that this feature pro- 
vides. With an OMTI brand disk controller 
installed in die HDA-506, veiy impressive 
data transfer rates are possible. 

Spirit sells the HDA-506 in any con- 
figuration that you might need. They will 
sell you as much equipment as you need. 
If you have an old drive and a controller on 
your Workbench looking for a home, they 
will sell you tlie interface and any needed 
cables. If you are just starting out, they will 
sell you a complete package that supplies 
all die needed parts and cables. 

Witli the current low prices for ST- 
506 drives and controllers, this product 
certainly deserves a look. 









Spirit Technology Coip. 
220 West 2950 Soudi 






Salt Lake City, Utah 84115 






HDA-506, $249-00 
Inqiwy ^200 
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The Supra Controller 

An indepth review of the Supra Controller 



by Jon A. BouUe 

Welcome back.... 

Last time we talked, we were concerned 
with the more mundane topics of hard 
drives. This time, I hope to give you 
something that will provide you with 
information that might be of particular 
interest, 

I am an inveterate shopper. 
Before I buy anything, I generally research 
it rather thoroughly. Sometimes this takes a 
while, but I have found through sad 
experience that impulse buying is bad for 
the health of my checkbook, not to mention 
the di VISA card. 

Before I begin, I want to reinforce 
in your mind that I am not going to 
recommend one brand over another, but I 
will "...tell it like it is..." If tlie controller/ 
hard drive has a problem that the 
manufacturer has not answered 
satisfactorily then you will know about it, 
and when it works, I will also tell you about 
it. In otlier words, this is not to be construed 
as an advertisement, or for that matter, as a 
critique of one either. 

I bought my controller and hard 
drive separately. I purchased the A2000 
controller made by Supra in October 1988. 
The hard drive I chose was the Seagate ST- 
157N. This is tlie new series of 3-5 inch hard 
drives that Seagate has recently been 
offering. I made some assumptions before 
buying this particular hardware setup, and 
as usual, I got burned because of my 
assumption. Well, not burned, just singed 
slightly. 

The Supra controller for tlie 
A2000 is NOT a hard card. You could 
probably mount a 3-5 inch drive on it by 
doing some real fanc)^ jury-rigging, but I 
wouldn't recommend it for the average 
person. In fact, I wouldn't recommend it to 
anyone. It is simply a controller card a la 
CBM's A2090A controller card. 

Installation of the controller card 
is simple. Open the case of your A2CX)0, put 
the screws somewhere the cat won't play 



with them, take out the plate covering the 
port closest to the floppy drives, insert the 
controller card, replace the plate hold- 
down screw, and it's done. Simple as that. 
The important tiling to remember is tliat the 
controller card should go in the slot closest 
to the floppy drives. The reason for this is 
that the bus positioning has something to 
do with the bus priority. So you want the 
highest priority^ you can get for your 
controller. You should note that the end of 
the controller card that is exposed to the 
outside of the case has a female DB-25 
connector installed. This is so you can 
"daisy-chain" SCSI devices to the 
controller. This is handy for further 
expansion to your system. 

The next step was installing the 
3.5 inch drive into the box. There are two 
ways to do this. First, if you choose to have 
only one 3-5 inch floppy drive, just mount 
the hard drive where the second floppy 
drive would mount. If you have a face plate 
for your 3.5 inch drive, remove die blank 
face plate from the cover of your Amiga. 
Otherwise, you could leave the blank face 
in place and simply slide the hard drive far 
enough back to clear the front of the case. 
Although I chose not to do it this way, it can 
be easily done. If the screw mounting holes 
on the floppy drive plate do not allow you 
to do this, it is a simple matter to elongate 
the holes with a dremel tool. Just remember 
to do your work away from the 
motlierboard. Metal shavings may fall into 
it if you work directly inside tlie 

computer. Next, utilize one of the spare 
power plugs coming from your main 
power supply to power your hard drive. 
You can also connect the small LED leads 
from the hard disk light on the front of your 
2000 to the hard drive itself. There are two 
small wire leads on the ST-157 to 
accommodate ttiis. 

The second method of installing 
the hard drive is the one I chose. I mounted 
the 3.5 inch drive in the 5.25 drive bay 
below the floppy drives. I purchased a kit 



from a local electronics supply house tliat 
was a universal 3.5 inch mounting kit. I 
mounted the ST-157 in the mounting rails 
and [hen mounted tlie rails in the 5.25 inch 
slot. It sounds simple, but don't let it fool 
you. I had to remove it, because I couldn't 
get my fat fingers down into those tiny 
places to install the proper cables for the 
hook-up. 1 then fed all the cables through 
from back to front, attached tliem in dieir 
proper places, and then re-installed the 
hard drive. Everything worked the first 
time, no blue smoke. I guess I got it right! 

Be sure when you attach die 50 
dip pin cable to die controller card diat pin 
one is located and that the highlighted 
conductor is on pin one. Then, when you 
attach the other end of the cable to the hard 
drive, take care tliat you match the 
highliglued conductor to pin one on die 
hard drive. Which pin is pin one? Good 
question. If you look at most drives there 
will generally be some kind of mark or 
printing to indicate which end is pin one. 
One drive I own has pin 49 and 50 marked 
so I just went to the odier end. The other 
drive has pin 2 marked. Just look at it, tlie 
clues are there. The controller card will 
usually be marked in a similar fashion. If 
you don't match Uiem nothing will happen. 
You have to re-install the cable. In some 
cases you can damage the hardware when 
you apply power. This usually occurs with 
older drive/controller combinations. 
Newer hardware is a little more tolerant. 
/Vnotlier word of caution, hard drives are 
sensitiv^e to static. Be sure to ground 
yourself before you start handling tlie 
drive. Or you can buy a ground strap that 
attaches to your wrist while )^ou are 
working. Just rememben 
it's better to be safe than sorr^-! 

A little warning here, if you feel 
even the slightest bit uneas\' doing this kind 
of thing, do yourself a favor, go to a dealer. 
Tell him what you want and how you want 
it and they will generally comply, and listen 
to what they have to say. Sometimes they 
have a better idea than you might. 
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Supra ZMB DM Hard DisX Fomttta- vS. lb 



llHhnrTfigl 




The Supra Hard 
Disk Fonnatter 
screen. 



On power up, die hard drive 
should go through an internal test. This is 
built in and is nothing to worry about, (nor, 
for diat matter, is there anything you can do 
about it). The access light will briefly flash 
and then everytiiing will stop. Once this 
happens you know you are ready to 
progress to the next most important step, 
formatting your drive. 

Supra provides one of the easiest 
methods of setting up your hard drive for 
operation. Put tlie disk provided by Supra 
into DFO; and re-boot the system. The 
entire process is now completely scripted. 
You just need to answer tlie questions as 
they are asked and the scripts take you 
where you want to go. 

It first does a "SupraMount" 
command. This is some tiling like the 
AmigaDOS "BindDrivers" command but 
does not require anything to be in your 
Expansion drawer If the response from the 
SupraMount command tells the system that 
there is a hard drive out there, but it isn't 
correctiy formatted, it will then tell you that 
there seems to be a problem witli your hard 
drive; would you like to fonnat it? If you 
respond "yes" the script takes you to tlie 
"SupraFormat" command located in the 
Supra drawer on the boot disk. 

SupraFonnat is almost totally 
automated and is a real joy to use. If you 
have ever used "DiskManager" for iMS-DOS 
machines or fought your way tlirough the 
documents that come with the hard drives 
from some manufacturers tiien you will 
understand why I like this so much. 
"SupraFormat" automatically goes out to 
your new hard drive and determines what 
you have installed. You don't have to tell it. 
It goes one step further by being able to 
identify the physical drive you have 
installed and also tells you the adapter card 
you have installed. It's a really nice touch, 
and the designers of tliis ought to be 



rightfully proud of tiieir handiwork. 
Besides diis feature, you also have tlie 
choice of picking xlie controller/hard drive 
combination via menus. 

The first menu will allow you to 
set up tlie initial parameters for all the Supra 
drives currently available. They range from 
10 MB capacity up to 250 MB. Plus, tliese 
can be execoited via "right-Amiga- 1 
tlirough 10". This menu set is designed for 
those who choose to buy the entire hard 
drive, controller, and external enclosure 
from Supra. This set also includes the 
"Other' option which allow^s you to set up 
your "home brew" hard drive/controller 
set. 

The second menu set is for 
various controllers tliat are currently 
available. An interesting note to this is diat 
here is where imbedded controllers 
mounted on factor}^ SCSI hard drives are 
listed. Listed are 24 SCSI controller/hard 
drives plus the necessary "Other" 
controller. This would allow you to mount 
a SCSI controller that is not listed. And if 
you found one diat wasn't listed, you really 
had to lookl See the listing at die end of diis 
article for those conu-ollcrs currendy 
supported by this menu set. 

The third menu set lists 23 
common hard drives which you can set via 
the software and, of course, the "Odier" set 
up. See the listing of the current support of 
hard drives at die end of diis arUcle, also. 

The last menu command is called 
"Auto-calculate on or off. This is an 
invaluable option, especially for the new or 
less experienced user who is not sure of 
track capacities. By simply selecting "auto- 
calculate on" the software will allow you to 
decide, in megabytes, how big you want a 
partition to be and then calculate the 
necessary track configuraUon. 

Enough about menus, they are 
really self-explanatory^ as is die rest of the 



program. As a last word on diis subject, this 
hard drive format program should be the 
standard everyone adheres to. Simple, 
intuitive, easy to use, and reading the docs 
isn't all that necessary\ 

See the photo to see how I set up 
my hard drive. Tw^o partitions, one of 7 MB 
and one of 40 MB using die 1.3 FFS system. 
As you set diis up, the windows on the right 
side of the screen change automatically. 
The software recognized that I had 6 
surfaces and also recognized that die hard 
drive had 6l5 tracks. The hard drive 
documentation said I had 625 tracks but it 
must be noted that diis is an auto-park drive 
and the heads need somewhere to land. I 
can only give a good guess diat diese ID 
tj'acks are used as die landing zone. You 
might also note diat several other diings are 
ghosted such as step-rate and write pre- 
allocate. These are not needed in general. 

The first step necessaiy is to 
insure diat your SCSI unit number is 
correct. If you have only one SCSI 
controller die unit number is 0. If you have 
more than one SCSI controller it must be a 
different number. The next step is to check 
\he LUN number. LUN means "logical unit 
number". Witli one SCSI device mounted 
such as one hard drive, tliis number should 
also be 0. If you add a second hard drive or 
any other SCSI device then, when 
formatting that unit, you should change 
diat number to 1. SCSI controllers can 
operate (in general) a total of seven devices 
numbered 0-6. Flere you have to 
remember that widi computers is 
considered somediing when actually is 
nodiing! (I can't figure diat one out.) For 
our purposes w^e must go with the industiy 
convention, nodiing means somediing to a 
computer. Actually, die hard dri^'e could be 
LUN #6 or ^5 for diat matter, but diat is just 
confusing to the average user. Call it and 
all will go well. 

StiU with me? Good, here comes 
the next part which is as simple as it can get. 
SupraFomiat allows for up to 5 partitions 
on a hard drive. In most cases this is more 
than ample. The top row asks you for the 
size of the partition you want. Click your 
pointer inside the box, delete the number, 
and replace it with yours. If you get a 
requestor saying diat you are asking for 
more space than the hard drive has, click 
die cancel box and keep on going. You 
should have also noticed that die track 
numbering changed to correspond with 
the capacity you chose. The second block 
down asks you whether or not you w'ant a 
new or old file system. This is a toggle so 
by clicking the box you can have die file 
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Are you intimidated by Databases? 
Too busy to read a huge manual? 

That's why you need Mail-O-Dex. 

Mail-O-Dex is a full featured, easy to use 
mail merge manager. But it doesn't stop 
there! It also combines the features of a 
RoloDex, a Phone Dialer, a Label Printer, 
AND direcf/y supports most popular Word 
Processors. With easy to use VCR style 
controls, you probably won't even need the 
easy to understand manual. You can search 
any or ALL fields, and define field titles. 
Label sizes and spacing are adjustable. 



Best of ail, it's only $49.95!! 




Available at a dealer 
near you or onier 
direct. Send c heel: or 
money oi^cr payable lo 

Dealer inquiries welcome 



KarmaSoft 
P.O. Box 1034 
Golden, Co. 80401 
(303)277-1241 
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system you desire. The lowest box says 
"Zero". This is also a toggle to highlight or 
unhlghlight tlie text. This is used when you 
would like to completely erase a partition 
by wTiting zeros to it. You can thus isolate 
the rest of the drive and leave the other 
partitions unefFeaed. Ok jump to the next 
column to the right. This will set up your 
second partition. Once again, plug in the 
size you would like it to be and then go on 
to the third and fourth, until you have used 
up all your disk capacity. 

The bottom row of commands is 
the next step. If you have never formatted 
this particular drive, then it is best to have 
the "map option" on. This performs a very 
important step in die low level format. A lot 
of hard drives are shipped with piiysical 
errors in tlie disk media. If your read/ write 
heads were to try to read or write to tliat 
physical defect you would get a volume 
read/write error requestor and never be 
able to get past it. The map function 
actually goes out to the disk, reads and 
writes to every block. If it detects that there 
is an error to a specific block, it re -assigns 
it somewhere else, it works essentially like 
the Amiga DOS command "assign". An 
example: If block 19835 has an error, the 



map function finds it and then codes an 
assign of that block. Thus it says "ok, 19835 
is bad so now when ever diere is a call to 
read or write to that block I w^ill send it to 
block 21453". Please ^ this is only an 
example. Don't take me to task over what 
it actually does with the mapping. You only 
have to do tliis once when you first sec up 
your hard drive. If you choose to change 
your partitions at a later date, this can be 
turned off Unless you have somehow 
acquired a ''Read/write error". Then you 
would definitely w^ant to re-map the disk 
surfaces. 

The next block contains the 
"Format" command. Click on tiiis block 
witli your mouse button and your 
formauing begins. It puts up a requestor 
that tells you that by proceeding you will 
wipe out all existing data on the drive. If 
that's ok with you then go aheaid. The 
formatting process will begin. 

The next block to tiie right says 
"Do Zero", This is the starter for the process 
of wTiting zeros to the specified 
partition(s). If you %^alue your data, don't do 
tliisl!! Once this is done, absolutely nothing 
will bring back what you loose. It will be 
forever gone. Exercise extreme caution 
when using this feature. 



The only block left is the "Exit" 
block. This quits tlie formal program. This 
allows you to leave diis window without 
doing anything. Otherwise, when the 
format process is complete a requestor 
appears telling you that the job has been 
completed and you should eidier turn the 
machine off or give it the ol' three finger 
salute (re-boot). Choose to re-boot, tlie 
remainder of tliis process is also automated 
and won't take too long. 

A new CLI screen appears, it tells 
you that it is doing the "supramount" 
command. This is loading your hard drive 
information inio the system. Now instead 
of a message telling you tliat your hard 
drive has a format problem, it asks you if 
you want to install Workbench on the 
drive. Answer yes and it will tlien ask you 
to place Workbench 1 .3 in any drive. When 
you do tliis it will copy the necessary' 
directories and commands into DHO:. After 
completing tlie Workbench copy it will 
then ask you to insert Extras 1.3 in any 
drive. Il then copies the printer drivers and 
keymaps along with other utilities into 
DHO:. 

Have you noticed anytliing yet? 
You should have. Unlike other low level 
format procedures, this one does not 
require you to format the drive partition 
with the AmigaDOS format command. It's 
done for you in tlie original format 
procedure. It also did something else. 
Open a CLI window and t\-pe "info". You 
now have a new hard drive partition called 
"bdO:". This was also created via tlie format 
procedure. In here, you will find all the 
necessar)* tilings for auto-booting from 
your hard drive (as long as you have the 1 .3 
KickStart ROMs installed). The new Supra 
controllers come already equipped witli 
the auto-boot ROM installed on the 
controller board. Another point to note; 
this controller and software does not use 
tlie mountlist in your devs: directory to 
mount the hard drive partitions. Everv'thing 
is imbedded in the "Supra Mount" 
command. The major draw^back to diis is 
tliat you cannot adjust the buffer size via die 
usual mounUist method. You cannot 
mount any other devices with this 
command eitlier. If you are mounting RAD: 
or vdO; or newcon: this must be done 
through the AmigaDOS "Mount" command 
with an entr\^ in your mounUist for that 
device. This problem, if you see it as one, 
will be addressed in the next release of the 
software. 
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Now for some tips on using your 
Supra controller. Do not use the AmigaDOS 
command "AddBuffers". This will cause 
you an unreasonable amount of read/write 
errors when accessing the hard drive. This 
is being fixed in the next version of the 
software as well as a few other things. 

Since the first partition on the 
hard drive is in the old file system, you 
cannot use the 'Xock" command. Lock only 
works with FFS (fastfilesystem). I wish they 
had fixed tliis but it would appear that tliis 
is a CBM bug not a Supra Corp. bug. 

The "blitzdisk" command that 
came with TxEd Plus v 2.01 worked with 
this hard drive/controller, but Charlie 
Heath said tliat it might cause problems so 
I deleted it from my startup-sequence. 
Happily, the patch for blitzdisk has been 
posted to PLINK, and Fm happy to report 
that it works extremely well with this 
hardware combination. This performance 
enhancement is definitely wortli it. I won't 
include those results here since it has no 
bearing on the actual drive performance, 
but, boy, does it work[ 

Not everything is as I 'would like 
it to be with this controller. I don't like the 
non-FFS first partition. I wish you could 
mount the 3.5 inch hard drive on the card. 
I would like the Lock command to work on 
the first panition. 

The newest boards, being 
shipped at the time I am writing tliis, have 
two jumpers on the board as well as a 
daughterboard in place of one of the PALs 
that used to be in the board. This did cause 
a little problem trying to mount the OMTI 
adapter card on the controller card. The 
stand-offs provided by Supra are just a little 
too short. You could probably find longer 
ones at Radio Shack, but we didn't bother 
(we used tie-wraps). Please, I don't 
recommend this. Get tiie longer stand-offs. 
The person who I was helping couldn't 
wait for us to do it right and chose to do it 
tliis way. It worked out alright, but there is 
the chance that something could slip and 
tiien you could possibly let the blue smoke 
out of your chips. 

Any compatibility problems are 
being fixed as they are found. The jumpers 
and tlie daughterboard that are on tlie 
newest release of the controller were 
placed tJiere due to an incompatibility 
problem with the Micron memor>^ 
expansion board. Also, if you also own an 
8-Up board from Microbotics there is a 
problem here. Apparently, the 8-Up board 
is extremely noisy in RFI (radio frequency 
interference). When we got the second 




Spotlight on Software 

AMAX 135.00 

ANIMa^c 59,99 

AfchipelaQos ., 27.50 

Baud Bandit ,.., .., 33.99 

Can Do 88.99 

Cre»sDOS ..„, 24.99 

CygnusEd Professional 64.69 

Deluxe Patnt ill 100.00 

Design 3D 60.00 

Digi Paints 61.99 

Digi-View Gold ., 140.00 

Dunlap Utilities, 51.99 

Falcon Mission Disk 18.50 

HtSoft BASIC Professional .... 1 10.00 

Jigsaw 27.50 

MAC 2 DOS 75.99 

Optlcks..., 120.00 

Poge Render 3D 93.00 

PageStream „ 130.00 

Pen Pal 90.00 

Pefformef (Elan) .., 41.00 

Photon Point ]| .., 99.00 

PIxetScript ., ,., 95.99 

Red Ugtitning ,„., ., 43.99 



Great Prices! Shipping 
based on weight and zone. 

For Inlormation & Catalog CaU 
Vbice 414-544-2066 
Pursuilabtu BBS 414-544.6567 



Torgtian 33.99 

Turbo Sitvef 120.00 

Turbo Silver Terrain 33.00 

TxEd Ptus ..,.....,..,. 55.00 

Spotlight on Hardware 

501 Memory Clone, Supra Coll 

68030 Bundle Call 

8-Upl Board OK DIP or SIMM 1 79.00 

Auto Droid 50.00 

fllckerfixer 475,00 

Foppy Drive, Internal 2000 .... 90.00 

Roppy Drive, Unkirtve .,. 140.00 

Future Soufkd 500 ...., .., 93.95 

HanO-Scon. C Ltd ,..,.,..,. 295,00 

HardPrame 2000 250.00 

Joystteic, Advanced Gravis ,. 39.99 

MIDLCMI 60.00 

MIDI, ECE 52,00 

PorKJsonk; UlOCamefa .... 215.00 

Perfect Sound 500/2000 ........ 66.93 

SCSI Controllef. Word/Sync 170.00 
SCSI/RAM lrTipGCtA2000 OK 290.00 

Spirit Boards OK 215.00 

SupraRAM 2000 2 Megs Call 

Orders Only Please: 
800-544^599 

Visa/MC/CODs 



2414 Pendleton Race ■ Waukesha. Wl 53188 ■ 9 AM to 5 PM M-F 
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A2000 Up and running, it refused to boot. 
We didn't even get a Workbench requestor. 
We pulled out the 8'Up board and the 
system functioned properiy. Since we had 

3 meg of SliMMS installed on tlie memor>' 
board, there was no way we were not going 
to make it work. The fix was really quite 
simple. We just moved the memor}^ 
expansion board to the last available Amiga 
slot on the motherboard and it worked as 
it should and available memor\^ showed a 

4 meg system. I blame the 8-Up board only 
because 1 have my 2058 board in the slot 
next to the Supra controller and have not 
experienced any problems with that 
configuration. We had to move the 8-Up 
board for the 2000 to boot up on tlie other 
system. The problems experienced by 
many users who also use "Quarterback", 
the hard drive back-up utility, have been 
fixed with the 5.3 release of the Supni 
software. 

The news from Supra Corp. is 
good. They are currently working on 
several things for the Amiga. Since they 
didn't swear me to secrec>-, I can tell you 
the news. New formatting software is in the 
works as well as a new documentation 
booklet. They are working on CD-ROiM 



and WORM interfaces utilizing the Maxtor 
optical devices. They also said that the 
controller should be able to use standard 
Apple AVL\C optical drives. Now all we will 
need is someone to put it on an optical disk 
so the Amiga can read it. ESDI interface Is 
being contemplated but is not a sure thing 
just yet. By tlie time you read xhis, the 
current method of mounting the drive will 
be completely re-written. This will do away 
with the non-ffs first panition. li will also 
make a Supra hard drive completely 
compatible with the CBM A2090a 
controller. This means that you will be able 
to remove a hard drive from a A2090a card 
and install it on a supra controller, being 
fully functional. The reverse will also Ixi 
true. The ROM will be upgradable via 
software. This means never having to 
upgrade a chip if CBM decides to change 
the parameters of the auto-boot sequence. 
.N^ew printed circuit boards should have 
been shipping for quite a while. This allows 
tlie removal of those jumpers that were on 
tlie latest one I saw, .^Iso, these new boards 
should allow for the mounting of 3.5 inch 
drives on them making them a hard card. 
No upgrade policies were discussed for 
tliose of us who have the older boards. 
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Even Up The Score! 




Let your Amiga give you the Advantage 
In making betten'nvestment decisions! 

Color grapliics of Individual Sltx:ks and General Market 
Trends help you make more profit in this volatile market. 
High Low Close, Moving Averages, Genicred Moving 
Averages, Voliunc, Relative Strength* Stochastics, Wilder s 
RSI, Cycles, IVcnd lines and Momentum. Powerful re- 
ports such as the Relative Strength Rcpfirt help you pick 
the best performers. Use the Market flaromelers to help 
you time your market entries. Update Stocks, Mutual 
Funds and Commodities manually or automatically. Easy 
to use communications included. 



Only $99.95 



See your local Dealer or Call: 

Software Advantage Consulting Corporation 

37346 Charter Oaks Bivd 

Mt. Clemens. MI 48043 (313) 463-4995 

Amiga and Ihe Investor's Advanlago Atn trad«nnarka of Ihelr la^p^d'we corrpanio^. 
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Here's how I rate the Supra controller: 

Hardware - 8.5 - The jumpers and the 
daughterboard knocked it down. Also the 
fact that a 3.5 inch drive can't be mounted 
on the card, "^lien these minor things are 
done, I'll give it a 95. 

Software - 9-0 - You would have to look far 
and wide to find anything tliat is as easy to 
use. The only real area that I would like to 
see changed is the inflexibility in 
parameters of mounting the partitions. 
Buffers can not be altered. They are stuck 
at 30. 

Documentation - 7.5 -It's better than 
some but needs less window dressing and 
more meat. Supra knows this and is re- 
writing the documentation now. 

Support Hardware - 9-0 - It's all there 
unless you are doing something 
unexpeaed with the hard drive. Make 



those stand-offs longer! All necessary 
cabling is there if you are mounting a SCSI 

imbedded device. If you are converting a 
non-SCSI hard drive you need to get an AT 
hard drive cable set to connect the hard 
drive to the OMTI or Adaptec controller. A 
three way power splitter is also included. 
You get a SupraDrive stick-on for the front 
of your A2000 so everyone will know there 
is a Supra inside. And the colors match too! 

Customer Support - 7.0 - It's only 
average. The biggest problem is getting 
through to them. Once there, you get 
ans-wers. 

Overall- You won't be sorry if you buy this 
controller. It's very fast, it's easy to set up, 
and it's easy to use. If Supra comes through 
with the planned upgrades, it will be 
SUPER, 

•AC* 



Table 1 




CONTROUJERS 


Adaptec 4000 


Omti 3527 


Adaptec 4070 


Quantum 40 S 


Epson HMD-726 


Quantum 80 S 


Epson HMD-946 


RodimeR0652 


Epson HMD-976 


Rodime 3000S 


HP 97504B 


Seagate 125N 


KonicaKT-510 


Seagate 138N 


MiniScrii>e8051 


Seagate 157N 


MiniScribe8425 


Seagate 225N* 


Newbur>'3170S 


Seagate 277N 


Newbury 3280S 


Seagate 296N 


Omti 3520 


Xebec SlH 10 


HARD DRTVTS 


HP 97501A 


Rodime R06S2 


HP 97501 B 


Rodime 3085S 


Epson HMD 726 


Seagate 125 


Epson HMD 946 


Seagate 138 


Epson HMD 9/6 


Seagate 1 57 


KonicaKT'510 


Seagate 225 


MiniScribe8051 


Seagate 25 1 


MiniScribe8425 


Seagate 277 


MintScribe8438 


Seagate 296 


Newbury 31 70S 


Tandon 755 


Newbury 3280S 


Tulin 226 


PTI 357R 


Tulin 240 


Quantum 40S 


Xebec 400 


Quantum 805 





The Supra Controller 

Retail: $249.00 
Discounted by various retailers 

Supra Corporation 
1 133 Commercial Way 

Albany. Or. 97321 

(503) 967-9075 Orders 

(503)967-9081 Teclinical Support 

Inquiry #222 
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Supra Controller Performance Specifications 



I chose to use "Diskperf as a 
source for testing the read/write 
speeds of all the hard drive/controller 
combinations. No thought to 
multitasking or otlier things like 
overscan picture viewing was taken 
into consideration. I feel that tliis is a 
fair way to test the speeds, and it wall 
give everyone a basis to work from in 
choosing a drive. Not everyone 
multitasks or views overscan pictures 
while running ano±er program. 
Diskperf may not be the best test for 
tlie job, but it's one that everyone can 
understand. It would appear to give a 
more "real world" type of speed result 
in its* testing. I don't have access to any 
state of the art equipment and neither 
does the vast majonty of users, thus 
"burst speeds" that can only be verified 
with an ociloseope won't even be 
mentioned. This also reduces some of 
those unrealistic claims by some 
controller manufact\irers to real life 
figures. Ano±er advantage of using 
diskperf is that iris readily available on 
most BBS and anyone can use it for 
their own testing. 

System I configuration: 

A 2000 motherboard revision 4.3 

A2058 Memory expansion with 2 

meg installed for a total of 3 meg 

system memory on board, 

2 floppy drives installed 

Seagate ST-157N 40 ms access time 

Interleave = lil 

dhO: = 7 MB 91% iiHl 

dhl: = 40 xMB 59% full 

Buffers as added by the Supramount 

fomiat = 30 

Standard 68000 CPU chip as installed 

by CBM was removed and a 

Motorola 68000 CPU chip installed in 

it's place. (Yes, there is a 

performance difference!) 

DHO: 7 MB 91% fiiU 

Files create/delete: 

create 14 files/sec 

delete 27 files/sec 
Directory scan: 

102 entries/sec 

Seek/read test: 

93 seek/'reads per sec 



read/write 

512 buffers: 

rd = 67216 by^es/sec 
wr = 28807 bytes/sec 

4096 buffers: 

rd - 187245 bytes/sec 
wr = 154202 bytes/sec 

8192 buffers: 

rd = 291271 bytes/sec 
wr = 201649 bytes/sec 

32768 buffers: 

rd = 436906 bytes/sec 
wr - 262144 bytes/sec 

DHl: 40 MB 59^/0 Ml 

Files create/delete: 

create 1 5 files/sec 
delete 31 files/sec 

Dtrectoiy scan: 

102 enmes/sec 

seek/read test; 

86 seek/reads per sec 

read/write 

512 buffers; 

rd ^ 68985 bytes/sec 
wr - 27887 bytes/sec 

4096 buffers: 

rd = 174762 bytes/sec 
wr - 131072 bytes/sec 

8192 buffers: 

rd= 291271 bytes/sec 
wr = 163840 bytes/sec 

32768 buffers; 

rd = 436906 bytes/sec 
wr = 201649 b)^es/scc 



Systemll Configuration: 

A2000 revision 4,4 motlierboard 

Microbotics 8'Up memory^ board with 

3 meg of 1 MB SIMMS installed 

giving a total system memory of 4 

meg. 

2 floppy drives installed 

OMTI 3527 KIL SCSI adapter 

Interleave 1:1 

Microscience IO6O half lieight MFxM 

capacity 80 MB (RLL capacity of 119 

MB) 28 ms access time 

dhO: = 10 MB 69% full 

dhl: - 26 MB 34% full 

dh2: = 26 MB 0% full 

dh3: = 26 MB 13% full 

dh4: = 29 MB 5% full 



DHO; 10 MB 69% full 

File create/delete: 

create 14 files/sec 

delete 27 files/sec 
Directoiy scan: 

95 entries/sec 

Seek/Read test: 

96 seek/reads per sec. 

read/write 

512 buffers: 

rd - 70849 bytes/sec 
wr =- 29127 b\^es/sec 

4096 buffers: 

rd = 187245 bytes/sec 
wr = 145635 bytes/sec 

8192 buffers: 

rd = 291271 b>i.es/sec 
wr = 174762 bvtes/sec 

32768 buffers: 

rd = 436906 byaes/sec 
wr - 291271 bytes/sec 

DHl: 26MB34%full 

File create/delete: 

create 16 files/sec 
delete 33 files/sec 

Directory scan: 

104 emries/sec 

Seek/read test; 

96 seek/reads per sec. 

read/write 

512 buffers: 

rd = 70849 bytes/sec 
wr = 29127 bytes/sec 

4096 buffers: 

rd = 187245 bytes/sec 
wr = 154202 bytes/sec 

8192 buffers: : 

rd = 291271 b>tes/sec 
wr = 174762 bytes/sec 

32768 buffers; 

rd = 436906 bytes/sec 
wr = 291271 bytes/sec 

The otiier partitions mounted on this 
drive were testedj but the results 
were not posted here since 
performance on tliese partitions was 
verv close to the results of dhO: and 
dhl:. 
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Mac-2-Dos lets you read and write 
Macintosh disl(ettes on your Amiga! 

Mac-2-Dos gives your Amiga the power to read and write files 
to and from 400k and 800k Macintosh floppy disks using a 
standard Macintosh-compatible 3.5-inch external floppy 
disk drive connected to your Amiga. 
Here are a few typical Mac-2-Oos uses: • Amiga 
users can now have access to the extensive 
variety of Macintosh clip art available on 
Macintosh disks! • Amiga users can now 
take their Amiga PostScript files (on a 
Macintosh diskette) to most any typeset- 
ting service bureau to be output on profes- 
sional typesetting equipment! •College stu- 
dents v/ho are required to have a pncey Macintosh 
can now choose the Amiga and still meet the require- 
ment of being Macintosh compatible! • Amiga users can 
transfer all kinds of files, like word processing and desktop 
publishing files, spreadsheet files, or database tiles. • Musi- 
cians can quickly and easily transfer Standard Midi Files (SMF) 
between the Macintosh and Amiga! 




Mac-2-Dos includes a custom hardware interlace, driver soft- 
ware, file conversion software, and, optionally, a Mac-compat- 
ible 3.5-inch floppy drive. The hardware interface plugs into 
the Amiga external disk drive connector or into the last external 
drive of the daisy-chained disk drives. The Mac drive 
draws its power from the Amiga. 

PACKAGE A: Package A includes a custom hardware 
nterface, file transfer software, and fife conver- 
sion software. Only $99.95 
PACKAGE B: Package B includes a custom 
hardware interface, file transfer softv/are, 
file conversion software, a Mac-compat- 
ible 3.5-inch floppy drive, and a software 
driver to allow the Mac drive to be used to 
read and write standard AmigaDOS diskettes as 
Only $349.95' 
LIMITATIOf^S: Mac-2-Dos is a disk file transfer utility pro- 
gram; it is not a communications program, nor is it a Macin- 
tosh emulator. It DOES NOT permit Mac programs to run on 
the Amiga. 

• Plus 53 00 shipping/handling, " Plus S5, 00 shippino/handling 

CO residents add appropriate sales tax. 



Mimilil 



ne FASTEST Hard Disl( Backup Utility! 

"Many in the Amiga community consider Quarterback V2.2 the standard 
of our community.,., f^y overall impression of Quarterback is smooth 
and complete.. ., For the average Amiga hardtfrive owner, Ouartert)aGk 
is still the utility ol choice." 

' Steve Dock, The Amiga Sentry March. 1989 

" Quarterback is the program I've chosen to keep my hard dssk backed 

up. .. Given the added power and lower price of Quarterback, it v/outd 
be my Jirst choice for a hard disk backup program," 

' Mattttew Leeds. Commodore Magazine, June. 1989 



"The fastest of the lot. Quarterback V2,0 copied my 4.3 megs to five 
floppies in four minutes and fifty seconds. The user interface is smooth 
and intuitive, the process painless and reliable, and the speed a good 
sigtit better than even second runner up... There are just enough 
gadgets around to make things easy, and not so many as to make them 
confusing This is the program we use to back up our hard disk and 
Be rnou II i data . " - Mark R. Brown. iHfO i26. May/June. 1989 

Only $69.95 Pius S3.00 snippmo .md hanriiinq CO residents add sales tax. 

Coming Soon! QUARTERBACK TOOLS 

A collection of high-quality user-friendly utilities. 



n"""i> 
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Transfers MS-DOS 
and Atari ST files 
to and from 
AmigaDOSf 



It transfers both binary (pure data) and ASCII (text) files. 

Let D0S-2-D0S be your PASSPORT 

to the world of foreign disk formats. 

Only $55.00 

Pius S3. 00 shipping nnd handling, CO residents aad appfopfiate safes tax. 





Circle 145 on Reader Service card. 



Central Coast Software 

424 Vista Avenue 
Golden. Colorado 8040 f^gl 
Phone 303/ 526-1030 ^^^ 
FAX 303/526-0520 ^^ 

Dealer Inquiries Welcome 



40 Amazing Computi7^gV4 .11 ©1989 



COMMODORE A590 HARD 

DRIVE PLUS 



by Paul Costa 

Amiga 500 owners seem to have the 
same problem that plagued A 1000 owners 
when the machine first became widely 
available. The expansion products that 
dealers carried in stock or had readily ob- 
tainable was very expensive and usually 
lackluster in performance. Now that the 
A500 has been shipping for two years its 
numbers cannot be overlooked by third- 
party hardware developers. Lower priced 
high performance hardware, which had 
been seemingly produced exclusively for 
A2000 systems, has begun to populate die 
ranks of possible A500 expansion devices. 
The A590 Hard Drive Plus is Commodore's 
first venture offering and Amiga hard disk 
controller complete with the hard disk. 

The A590 is functionally very similar 
to the 2090A hard drive controller board 
which Commodore markets for die A2000. 
Very compact and designed to match the 
A500's outer case, the A590 attaches to tiie 
expansion bus on die left side. Most expan- 
sion "boxes" somewhat interfere with typ- 
ing on the far left of the keyboard, die 
A590's slanted front eliminates this com- 
mon annoying problem for A500 owners. 

Tlie unit comes wiUi a 20 megab^^e 
Western Digital XT (IBM-506 type) hard 
disk widi 1.3 autobooting ROMS on-board. 
There are external connections for 7 (daisy- 
chained) 25 -pin SCSI drives available on 
the board along widi the optional internal 
50-pin SCSI drive replacement for die XT 
unit. The design of the board allows DMA 
(Direct Memor>^ Access) which affords the 
fastest possible operation for the drives 
installed. To obtain the full potential of the 
A590, a Kickstart 1.3 ROM equiped ma- 
chine is required. With the 1.3 ROM, auto- 
booting the system from the A590 provides 
faster access to the files. 

For Uie approximate retail price of 
$699, Commodore would have been com- 
petitive wi± most other hard- disk manu- 




facturers. But in Commodore's semi-infi- 
nite wisdom^ the A590 goes one better by 
adding a possible two megabyte on-board 
expansion capability. With the addition of 
die memory expansion, A590 owners will 
solve the problem of which to buy FIRST — 
the hard drive or the memory expansion. 

The package consists of the A590 
unit, ground clip, power supply, and t^^o 
setup disks. 

The two manuals which accompany 
the unit are well thought-out, and illus- 
trated, making installation of die unit and 
operating the supplied software less com- 
plicated than any other hard disk I have 
used. 

Installing the A590 involves setting 
die 4 DIP switches on the rear of tlie case 
which configure the controller to look for 
additional external SCSI devices, autoboot 
the system from the hard disk, and set long 



or shon time-out delays at power- up. 
Switch 4 is stated as being reserved for later 
use. With the DIP switches set, the ground 
clip must be installed by opening the 
expansion port on the left side of die A500 
and inserting the clip betw^een the ground 
shield located just below the motlierboard 
and the plastic housing on the bottom of 
die A500. This seemingly simple task was 
what took me tlie longest to accomplish 
because of the thickness of the clip and die 
relative thinness of the flexible shield. After 
approximately 5 minutes struggling with 
tlie clip insertion, I was able to finally slip 
it under the shield without damaging the 
bus connector or puncturing the sliield 
itself. The next step is to carefully slide the 
A590 into the 86-pin expansion bus con- 
nector. The unit assumes a ver)' secure fit 
on the bus and provides no bus pass-thru 
for future expansion. This is less of a 
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problem than it may seem due to the fact of 
the built-in RAM board. The power supply 
brick is of the same (rather backw'-ards) 
design as the supply shipped with the A500 
except that it uses a circular 4-pin connec- 
tor instead of the square 5-pin found on the 
A500's power supply. 

The A590 comes preformated under 
the new Fast File system (FFS) as DHO: witii 



Workbench L3-2 and Extras already in- 
stalled. The Fast File system on the 1.3.2 
update disk supercedes the 1.3 FFS and 
provides tlie hard disk with the fastest sys- 
tem yet devised for AmigaDOS. 

The afore mentioned "Secup" disk 
includes programs for HD prep, formatting, 
installing, partitioning, installing startups, 
making boot disks, parking the heads, 




changing the drive definitions, and remap- 
ing drive errors (not neccessary on SCSI 
drive because of the automatic error rem- 
apping of that type of drive). All of tlie 
programs included are well written and 
documented. The HDTooibox program 
allows rather complicated processes such 
as partitioning, remapping, verification, 
and formatting to be controlled by gadgets 
and sliders, making the process painless for 
the novice. 

The second manual contains instruc- 
tions for using the "RANi Test" diskette also 
included. Installation of expansion RAM 
involves disconnecting the drive and tem- 
porarily removing die hard drive and its 
mounting bracket from the A590 Controller 
board. RAM can be installed as 512K (4 
chips), Imeg (S chips), or 2meg (l6 chips) 
using inexpensive 120ns or faster CMOS 
256Kx 4 DRAMs- The board as shipped has 
a jumper that is set to "amnesia", placing 
the jumper in one of the 3 other corre- 
sponding positions is all tliat is required to 
configure the RAM board. As RiVM prices 
drop lower, the full two megabyte 
expansion price is reaching die S 200- $2 50 
range. At that low price many people can 
suddenly afford that "extra RAM board 
under the Christmas tree". 

Commodore has produced a hard 
drive that is not only competitive with the 
other drives currently out, but in offering 
expanded memor^^ capabilities, makes 
their product a much better value than 
similar HD controller, drive and memoiy 
combinations. I recommend dils drive to 
anyone considering expanding their A500 
system for as little money as possible while 
obtaining tlie greatest value. 

•AC- 



: A590 Hardfsk Controller Plus 

Commodore Business Machines Inc, 

1200 Wilson Drive 

West Chester. PA 19380 

(216)431-9100 

Inquiry #233 
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Amiga System Hardware 



UPS Tests and Reviews 



by Steven JL Bender 

Please refer to Part I and II of this series on 
uninteruptcd power source modules 
(Amazing Computing Vol. 4.5 and Vol. 4.6) for 
the technical details on Simtching vs. Linear 
Regulated Power Supplies, the techn ical aspects 
and details of various types of UPS units, and 
why they are necessary. 

AMIGA SYSTEM HARDWARE 

An A-1000 system which would be 
both equivalent to an expanded Amiga System 
and easily reproducible by many users was 
selected as tiie test load. An ordinar)' 40 Watt 
incandescent lamp, used in conjunction with 
the A-1000 and monitor, is the equivalent load. 
This load takes tlie place of an additional 2 iMB 
of system RAM (10 watts), an external Amiga A- 
1020 5 1/4" floppy drive (10 watts), a 20 - 40 MB 
hard drive (12-20 watts), and tlie losses present 
in a lightly loaded external switching power 
supply (0-8 watts) for the hard drive. In 
addition, THE WEDGE hard disk interface from 
RSI, and a DTCo 150 (MFM) hard disk controller 
were left connected to the A~1000's expansion 
pon, loading the A-lOOO's internal SPS during 
the UPS tests. 

The hardware configuration used in 
testing the UPS units consisted of an A-IOOO / 
512K system unit with one external A- 1010 
floppy disk drive, THE WEDGE hard disk 
interface, an MFM hard disk controller, a 
Thomson 4375M UltraScan multiple frequenc>- 
scanning monitor, and tlie equivalent load. Tlie 
three components were plugged into a "one to 
sbt" outlet strip plugged into the Ul'S unit. The 
external equipment was turned on togetlier 
using the power switch present on the UPS unit. 

The Amiga A-1000 system unit/A- 
1010/WEDGE/DTC controller combination 
draws around 25 Watts / 35 VA, The Tliomson 
4375M UltraScan (adjusted witli tiie brighmess 
at center detent, contrast on maximum) draws 
90 Watts / 125 VA. And the bulb, equivalent 
load, is 40 Watts / 40 VA. Therefore, the load 
presented to each UPS unit tested was aroimd 
l65 watts. Since two of the tliree load devices 
utilize switching power supplies, the total 
power draw of this load is equal to 
approximately 200 VA. 



THE TESTS 

Ten switching UPS units were tested. 
Each UPS was turned on without a load 
attached, and charged for at least 12 hours. Then 
the in-use timed tests were conducted. An 
Amiga A-IOOO system (as described above) was 
powered by the UPS. Kickstart and Workbench 
1.3 were loaded. PerfMon was used as the only 
task and to check that the computer didn't hang. 
The UPS line cord was then pulled from the wall, 
causing a power failure and battery backup 
condition. The time was recorded until the CRT 
screen went blank and tlie lamp went out. 

THE UPS REVIEWS 

THE EAiERSON PC-ET SUDVUINE 

Tlie Emerson PC-ET Slimline is an 
under-tlie- monitor type UPS. All Emenson UPS 
units produce a sine wave output on battery^ 
backup. In addition, the PC-ET is an on-line UPS 
unit designed and made in the U.S.A. The heavy 
gauge steel case is black on the bottom, bark 
beige on the top, blending nicely with many 
computer installations. With dimensions of 
15.5" wide x 14.5" deep x 2 1/4" high, it weighs 
23 lbs. and takes up less space than a tUt / swivel 
monitor stand. The front panel contains six 
power switches, the Master Power switch and 
five switches which control each of the five rear 
mounted A.C. outlets. Tlie PC-ET on-line UPS 
can effectively power up to 720 VA of computer 
equipment on the filtered lines, but only 250 
watts / 360 VA under battery backup conditions. 

The PC-ET has five NEMA^15 A.C. 
outlets and a 10 ampere A.C, line circuit breaker 
in the rear. Three oudets come from tlie on-line 
inverter, the other two are off the A.C. line filter. 
The A.C. line cord is permanendy attached. 
When the unit is connected to an ac outlet and 
turned on, an amber LED above tlie Master 
Power Switch lights, and the faint rush sound of 
a whisper fan can be heard up to several feet 
away. 

Despite the minimal area on the front 
panel, two LED bar graph displays are 
prominent. One display is for battery charge 
level, the otlier registers the A.C. load capacity 
being sustained. These are similar to tlie bar 
graph displays present on the DRS unit, but have 
five green rectangular LEDs across, in each 
display. A separate green LED shows if tlie A.C. 



Part III 

line is present. There is another amber colored 
LED next to tlie A.C. load capacity bar graph to 
indicate an overload condition. 

Normally, under A.C. operation, all 
five of tlie LEDs in the battery capacity display 
are lit, as is the LED indicating A.C. power. 
Under battery backup conditions, all of the 
LED's on battery capacity display start off 
brightly lit. Then the right most LED starts to 
pulsate, going bright / dim about three times a 
second. Eventually this pulsing makes it 
dimmer, and then diat LED goes out, causing the 
next one to start pulsing. This continues until all 
five LEDs are extinguished. According to the 
manual, approximately one minute before the 
batteries are totally discharged, an audible alarm 
is supposed to sound, I never heard tliis audible 
alarm signal in eitlier in-use trial. Mter all five of 
tlie battery capacity LEDs have gone out, only 30 
seconds of battery backup operation is left, and 
then tlie unit shuts down. 

In operation, the unit is quiet, except 
for the faint rush of air due to the fan. Since the 
unit is ON-LINE there is no switching effect 
when the A.C. power is lost. When some of the 
battery backed outlets are active, by depressing 
die front panel switches, the A.C. load capacity 
LEDs start to light. These displays indicated 
three LEDs lit (nominally 2l6 VA) using the 
erJianced Amiga / Thomson monitor computer 
system. This is within 10% of our calculations on 
that load, and ver^' accurate. 

This is the only unit I have seen which 
really could be rated as having NASA QUALITY 
construction. The unit is made well with 
circuitry on several high quality multilayered PC 
Boards. It uses more tlian a dozen IC's (some are 
op to-electronic IC's). I disassembled the PC-ET 
somewhat, but failed to find the output devices. 

Tliese power transistors appear to be 
mounted inside a big machined, finned, block of 
aluminum, which takes up about one-fifth of the 
interior of the unit. This heat sink is force air- 
cooled by the fan. Air exiting out the rear is 
generally warmer than room temperature, but 
usually it is only slighdy warmer. The heat shik 
is also diermally linked to a flat machined 
aluminum plate which is almost a quarter inch 
thick, and about tw^o diirds as large as the case. 
Considering the overall qua lit)' of the internal 
consmaction, I have no doubts Uiat tlie output 
devices used are more than adequate for the 
task. 
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A separate PC board holds the line 
filtering components. Heav^ duly fenite core 
coils, caps and MOV's are present right off the 
A.C. line cord for RFl/EMi line protection. The 
spike and surge protection should be excellent. 
The output wave form was always an excellent 
sine wave, except under gross overload 
conditions. There are some small uansformers 
and large capacitors interspersed throughout 
the unit. All the PC boards are neatly stuffed with 
precision, close tolerance parts. 

This UPS does not get hot during 
battery backup operation or normal battery 
recharging after full battery depletion, but it can 
get warm on top of the case. Til is unit will cold 
boot if A.C. line power is absent when it is 
turned on. 'fhe two batteries are each nited at 6 
Volts / 10 amp-hours. Tiiis is not a large battery 
capacity\ but considering the smaU size and the 
low UPS backup rating of 250 watts / 360 VA, it 
is quite reasonable. From a depleted state, the 
batteries seemed to l>e charged in under an 
hour. It performed perfectly in our in-use tests. 

When subjected to an overload, the 
Emerson PC-ET simply turns itself off. This was 
somewhat disappointing but expected. Since 
the inverter circuits always power the load, it 
lends to be the weakest link in tlie system. It 
needs superior protection from any overload 
condition. 

Using about a 400 Watt lond on the 
UPS outputs, the inverter shut down after about 
10 seconds. Higher levels of overload caused it 
to shul-down faster. It was subjected to an 
overload test, A laser printer (and the probe of 
an oscilloscope) was connected to tJie A.C. 
ouiput. When the laser printer was first turned, 
on during the warm-up and initialization C7>0 
watts), the PC-ET sensed liie ovedoad and shut 
down in under a half second. On the scope, the 
usually pristine sine wave became a noise-like 
signal as the circuiu>' u-ied and then failed to 
supp<j>rt the overioad condition. After that type 
of shutdown, the A.C. power switch must be 
turned off and turned on again to restan. Even 
after numerous tries with this overload, tlie PC- 
ET UPS survived. On tlie primary side, tiie A.C. 
line circuit breaker will carry a total of almost 
1 200 watts before it will trigger and discontinue 
ptnver. 

Tlie Emerson 90 day warranty is for 
repair or replacement. This is the shortest 
manufacturers warranty of any UPS tested. 
Considering the high quality construction and 
the high price, tliis is certainly a somewhat 
curious situation. I guess it is because tills is an 
"indusiriar unit. Tlie unit carries FCC Class A 
certification and it does produce much more TV 
interference when in operation than any other 
UPS unit I have tested. 

Overall, 1 have to admit, that 
producing such a compact and diminutive sine 



wave unit is remarkable. It can probably handle 
just about any expanded A-1000 or A-2000 
AMIGA System likely to be encountered. (But 
not the laser printer pleaseO The system unit and 
monitor probably will not draw more tlian 360 
VA / 250 watts, but, if it does, the front panel LED 
indicator will let you know- about it immediately. 
Printers and non-essential accessories can draw 
another 360 VA on the two filtered non-UPS 
output lines. 

The manual that came with the PC- 
HT UPS contains 10 pages of compreliensive 
technical specifications and non-technical 
information, safeguards and instructions. It is 
good. 

The PC-ET UPS backed up the Amiga 
A- 1000 /Thomson / equivalent load computer 
system for 15 minutes and 36 seconds on tJie first 
trial and 15 minutes and 43 seconds on llie 
second trial. List Price: S995.0O. 

SUMMARY: Emerson PC-ET UPS 

Positive attributes: Pure sine wave 
output, on-line operation, cold boots in absence 
of A.C. pow'er, significant line surge/line 
filtering protection, load power center switches, 
batier>' reserve and AC. load bargraph read- 
outs, NASA type construction, steel case, and a 
very small size. 

Negative attributes: high price, no 
external batter>' jacks, Inaudible audible alarm, 
only FCC Class A certified, produces TV 
interference, much less backup time than less 
expensive UPS units. 

THE INTERTEC PSS-550 
TJLTRA-THEV UPS (TM) 

The Intertec Personal Standby 

Systems "ULTR^V-THIX UTS^ line consists of a 
smaller 360 VA unit using the same size case as 
tlie PSS-550 tested. A larger lOOO VA unit is also 
currently in production. Two other units, rated 
at 240 VA and 120O VA, are on the drawing 
board. Physically, the PSS-550 unit is a heavy 
UPS, weighing in at about 40 lbs. 

The case is light beige color, to match 
many computer cases. It is made of a hefty 
gauge steel, with added steel shielding under 
tlie top. It certainly gives one the impression of 
quality workmanship. The front panel has a 
lighter beige colored plastic bezel imitating tlie 
look of a diminutive PC clone. The PSS-550 is an 
"under the monitor" low profile design UPS 
made in Taiwan. It is 15.75*' wide, l6" deep and 
only 3" high, about Iialf tlie height of nio.st UPS 
units. This unit is rated at 480 Watts / 550 VA, the 
largest capacit>^ of any UPS tested in this 
comparison. 

The unit incorporates a pre- 
programmed 8049 microprocessor which 
initializes with a five second self test. This test 
lights all tliree of the front panel LEDs. There are 



no Opto-electronic circuits here, fast FET's are 
used. This unit is designed not to cold boot if 
exterior A.C. power is absent when the A.C. 
power switch is turned on. 

The tliree batteries are rated at !2 
Volts / 4 amp -hours each. The capacity seems 
less than would be exp>ected in a unit rated at 
550 VA, however, it perforaied well in our tests. 

In openition, the unit is very quiet. 
The user manual states that a synclironized 
transfer takes place (this accounts for the four 
second delay when transferring back to the A.C. 
line from battery backup). The main power 
switch is found on the rear panel, and it is 
suggested that tliis switch be left on at all times, 
using the front panel switches to control each 
individual computer or peripheral device. 

Under normal conditions, only the 
green LED glows indicating normal A,C, line 
operation. A yellow LED indicates high A,C, line 
voltage. When the unit has gone to batter>' 
backup, the green LED extinguishes and tlie red 
led turns on. The front panel has five rocker 
switches, tliree with red rockers and tw^o witli 
black rockers. These control the fi\'e rear 
mounted NEMA-1 5 outlets. The tliree right most 
outlets are active during battery backup while 
the two central ones are not. 

A front panel momentary push 
button switch silences the beeps of tlie audible 
alarm. The audible alarm is ftiirly quiet, but 
works immediately when the UPS goes to 
battery backup. During the initial warning, it can 
be silenced by hitting the button. The unit beeps 
twice a second for about twent\' seconds after 
experiencing a power failure, after that it is 
silent. I^ter, when the battery is almost 
depleted, the alarm sounds by rapidly beeping 
for about sixty seconds warning of impending 
shutdown. At some point, the unit reaches a 
predetermined lev^e! of batten^ discharge and 
turns off. 

Internally, construction is spacious 
and roomy. It uses one PC Board for its 
complement of seven IC's, three opto-isohuors, 
and many small transistors and other close 
tolerance pans. The low profile transformer is 
not a torroidal, but a compact height unit of 
conventional design and substantial in both size 
and weight. Construction is definitely heavy 
duty. Two (MJl 1032) TO-3 output transistors are 
mounted on tlie PC Board. The rated power (1 20 
Volts / 50 Amperes / 300 Watts) capabilities of 
the two Motorola output devices totals 600 
Watts. Tliese two devices were mounted on two 
separate heat sinks. Since they are not thermally 
linked to the heavy steel outer case, the small 
size of these heat sinks was a surprise. 

The entire unit stayed quite cool 
during normal A.C. conditions, battery backup, 
and battery charging conditions. It is the only 
unit tested which displayed no thermal 
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gradients any^^here on the outside of die case 

while using tlie Amiga system as a load. The rear 
panel contains one small, GMA style, 6 ampere, 
fast blow, fuse in series with the A.C. power 
cord. If this fuse blows, the unit goes lo battery 
backup. One other GMA fuse is soldered to the 
PC board between the two output transistors. 
This internal fuse is not user replaceabie. The 
User Manual stated that a spare fuse is included, 
but none w^as present with the sample 
evaluated. No connectors are present to connect 
external batteries to the unit. The A.C. power 
cord connects in the rear to tlie primar>' of an 
internal line filter. 

Other than tlie line filter, I noticed no 
MOV's or other specific surge protection 
components inside the PSS-550, In a letter dated 
April 3, 1989, Mr. Thomas Ferrante of Interiec 
stated, "Surge Protection is on the t PC ] board, 
but it is minimal. Future models will make tltis 
much more heavy duty." He also stated, "Please 
note we are F.C.C. certified Class A and B/ 
However, the sample tested did not have tiiis 
indication, or the prerequisite FCC ID sticker on 
its rear or anyw^here else. The manual / warranty 
did not mention this either. 

Because it was rated at 550 VA, tliis 
was one of two UPS units which was subjected 
to a ratlier stringent test, powering a laser 
printer I warmed up tlie laser and tlien pulled 
the UPS power cord, forcing it into battery 
backup. The Intertec UPS audible alarm beeped 
as it normally would. 

1 then started printing a very long file. 
Tlie laser printed out 20 pages before tlie PSS- 
550 UPS shut down. With my ear on the case of 
the UTS, I could hear it making faint straining 
noises each time the laser's heater element came 
on, doubling the power draw while it was 
printing. During printing for tlie first few 
minutes the UPS acted normally, then after 
about three or four minutes the second warning 
beep was on whenever tlie laser heater element 
came on. When printing this presents a power 
draw of about 750 w^atts. When idling the laser 
printer draws about 350 watts. The Intenec UPS 
survived. 

Normally, I W'ould suggest getting an 
800 watt UPS to backup a laser printer. 
However, both the laser printer and tlie Intertec 
UPS survived this test without blown fuses or 
problems. The 6 ampere A.C. line fuse did start 
to look a bit frazzled after tliis test. If the UPS had 
not shut down, that fijse would have blown in 
another few minutes. The UPS, on battery, 
powered the laser printer while it was printing, 
for more than 5 minutes. This unit is small but 
industrial strength! 

The 12 page manual, which originally 
came with the PSS-550, was obviously uanslated 
somewhere in Asia. It was incomplete and 
confusing. It did not provide much useful 



information, although it was comical from a 
standpoint of style. A somewhat revised manual 
/ warranty document came when the tests were 
nearing completion. It contained two diagrams, 
a chart, and the warranty terms. Printed on both 
sides of a glossy page folded in the middle, with 
a double sided half page containing 11 
questions and answers on UPS units inserted. It 
was a small improvement. 

The PSS-550 UPS backed up the 
expanded .Amiga A- 1000 / Thomson / 
equivalent expanded computer system, for 30 
minutes, 55 seconds. The warranty is 1 2 montiis. 
This unit deserves consideration. It is low 
profile, heavy duty, and unobtrusive in its 
performance. It works quietly, and has front 
panel switches for conu-olling the individual 
pieces of computer equipment; it certainly gets 
tlie job done. List Price: S 550.00 

SUMMARY? 

INTERTEC PSS-550 VA ULTRA-THIN UPS 

Positive attrii:)utes: All steel case, low- 
temperature design, five switch Power Center to 
control equipment, built like a tank, works 
quietly. Low price for its power capability. 

Negative attributes: Lack of 
significant line surge protection, less backup 
time capabilities than one or two other UPS 
units, is heavier tiian it looks, no external battery 
jacks, won't cold boot in the absence of A.C, 
power at turn-on. 

THE KALGLO LINE-SAVER (TM) 
LS-250 STANDBY UPS 

Designed and made in the U.S.A., the 
LS-250 LINE-SAVER, rated at 250 VA, is the 
smallest UPS in the Kalglo line. Tlie case is a 
cul>e like shape of hea\7 gauge aluminum tliat 
measures 9" x 7" x 5'V. AJi tiie otiier UPS units 
tested were more rectangular or computer case 
shaped. The front panel is slightly wider, than 
the unit is deep and contains most of the 
working controls. Left most, is die lighted p<jwer 
switch, tlie (audible alarm) ON / OFF / TEST 
UPS switch, and three discrete indicator LEDS, 

The LS-250 has dual N^EMA-15 A.C. 
outlets, two 32 Volt / 25 Ampere D.C. battery 
fuses (one internal in the external battery line, 
the odier user accessible in the internal battery 
line), a 2 Ampere A.C. line fuse, input jacks for 
an external battery, and a CEE-22 grounded cord 
receptacle on the rear. On the left rear are 
numerous silk-screened precautions. When the 
unit is connected to exterior A.C. power and 
turned on, the lighted power switch and the 
green status LED come to life, Tlie green, 
yellow, and red LEDs form a "traffic light" that 
denotes normal A.C. ©iteration (green), battery 
backup operation Cyellow), and battery 
depletion (red). An audible alarm switch (on / 
off / test) turns the audible alarm on/ofT or 
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Circle 190 on Reader Service card. 

initiates the UPS battery test position in the 
absence ot u power outage. 

The audible alarm beeps 
immediately, as soon as the A.C. pKDwer is lost, 
and everv' few ,second,s tliereafter. The beep rate 
grows faster as the ballerv' condition is depleted. 
Tlie audible alarm beeps each lime the yellow 
LED blinks (unless it is turned off with the 
audible alarm switch). As you are nearing the 
baiter>' depletion point, the red LED becomes 
brightly lit and the alarm changes lo a 
continuous whine. At tliat point, the yellow LED 
may go out, leaving either the red LED or the 
green LED glowing, and the UPS w^ill shut-off. If 
you haven't saved your work by then, it is lost. 

The LS-230 is well made with circuitry 
on tliree high quality PC Boards. The unit u.ses 
12 IC's including 3 opto-electronic chips. The 
Kalglo LS-250 uses two (2N5886) TO-3 output 
devices. These power transistors are mounted 
on a heat sink that is thermally linked to the rear 
of the case. A totai of four transistors and one 
regulator are mounted on tliat heat sink. The 
rated power of 80 Volts / 25 Ampere / 200 watt 
of these two output devices totals 400 watts. 

On the rear of the unit, the company 
provides a set of nine do and don't warnings 
silk -screened in very fine prim. The fir.st three of 
these warnings are: 1) Do not exceed 250 VA 
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total load. 2) Do not operate unit with less tlian 
a 25 watt load, 3) Do not operate on loads with 
a power factor of less than 0.5. Given that it is 
next to impossible for most users to measure 
either the wattage power factor or the actual VA 
of tlie load, these warnings should be treated as 
guidelines. 

In order to have the same test 
conditions likely to be encountered by a novice 
user (who might have ignored these warnings), 
none of the units were loaded during initial turn- 
on / charging. The LS-250 was operated without 
a load, and it performed perfectly. The only 
caveat I will mention is this: Don*t lay floppy 
disks or cassette tapes on top of the unit unless 
you want to erase them. This is a general rule 
that goes for any UPS housed in an aluminum or 
steel case. 

The NEMA-15 outlets are protected 
by a Coil and Capacitor (L/C) filter and Metal 
Oxide Varistor (MOV) components. The 5 
MOV's and m^o heavy duty ferrite core coils, and 
capacitors, form an RFl / EMI filter. The spike / 
surge protection should be excellent in this unit. 
Inside, the unit is neatly stuffed w^ith parts. They 
certainly get a lot into a small space. 

The LS-250 becomes warm during 
battery backup operation, and quite warm 
during battery recharging after full battery 
depletion. 

The Kalglo uses a special High Rate 
Charge circuit, which will eventually switch 
back to a slow trickle charge after a 
predetermined point of battery charge has been 
readied. If tlie red ( battery nearly depleted ) 
LED has gone on, the UPS system will soon shut 
off automatically, due to total battery deletion. 
Then, when the A.C. power returns, the red LED 
will stay on indicating that the battery' is being 
charged at about tliree to five times tlie normal 
trickle battery rate. 

This high charge rate allows a fuUy 
depleted battery* to be charged to hill voltage 
and almost full capacit)^ in a scant four hours. 
Willi a totally depleted battery, this High Rate 
Charge continued for ninety minutes before 
switching back to normal. 

The heat given off during this high 
rate charge was significant, but it did not appear 
to be a problem. Leave ample room for air flow 
between the Kalglo and other nearby 
equipment (especially on the left side of the 
unit). If at any time, the heat build-up appears 
to be getting excessive, simply turn the power 
switch off and back on again. This will usually 
recycle the unit back to the normal trickle 
charge (unless the battery is still quite depleted). 

The u*ickle charge rate will charge the 
internal battery^ in 12 - 15 hours, an external 
battery cannot be charged by the internal charge 
circuitry. While the rear panel has jacks for an 
external 12 volt battery, if an external baiter)^ is 
being used, it must be disconnected and 
charged witli an appropriate external battery 
charger. 



The Kalglo has almost all tlie best 
features of other UPS units, and should be 
considered for any AMIGA System. One other 
item w'orth mentioning, is the 24 montli 
warranty which is significantly longer than the 
norm. There is a set of alarm contacts tliat can 
be brought out for external use. Inside, there is 
also an A.C. line control pot for the technically 
inclined user to adjust the UPS kick- in point (this 
is the A.C. line to battery transfer point). It can 
be adjusted either somewhat higiier or lower. 

Two tilings are unique to the Kxilglo 
UPS units. One is the Power Outlet Wiring 
integrity Test feature, which uses die power on 
lamp, as a test for properly wired A.C. line 
sockets. If your house wiring is incorrect the 
lamp won't go on when the unit is turned on. 
Most wiring faults can be located using this 
feature. The other is the personalized Bum- in/ 
Final Inspection Repon. This is a series of five 
electrical and functional tests that a Kalglo 
employee does and signs for, on page 35 of the 
current (1989) version of tlie Kalgio 

INSTRUCTION: 
OPERATORS OWNER*S MANUAL. 

Documentation: The 36 page manual 
that comes with the Line-Saver UPS is very 
compreliensive. It covers all three sizes of 
Kalglo UPS units in depth. It is simply the l^esi 
reference I have seen on UPS. It includes safety 
instructions, theory, testing, system 
compatibility, use in foreign countries, 
specifications, graphs, charts, schematics, and 
more. The results of electrical tests on the 
particular UPS are included as mentioned 
above. A two page Technical Bulletin covers tlie 
Power Outlet Test feature. 

Three samples of the smaller Kalglo 
UPS were tested. One of these was an older 
version, the Kalglo LS-240 (discontinued several 
years ago). This older unit, manufactured in 
1983, still had the original Yuasa battery, now 
ahnost sLk years old. It was tested under tlie 
same load conditions as the other UTS units. 
Since the life expectancy of tlie gel cell batteries 
is generally considered to be 2 to 5 years, it was 
interesting to see how well the older unit still 
[>erformed. In our in-use timed tests, this older 
unit lasted for 3 minutes, 20 seconds on the 
Amiga A-1000 / Thomson / equivalent 
expanded computer system. Surprisingly, this 
bested the performance of the first sample of tlie 
LS-250 in both of its two in-use trials. This eariy 
LS-240 unit contained a Yuasa 12 volt / 6 ampere 
batte^>^ 

Unfortunately, as I just stated, the first 
sample of tlie LS-250 didn't work quite as well 
as expected. The current production sample of 
the LS-250, that was to be sent for this 
evaluation, w^as accidentally shipped out to the 
Comdex Show in las Vegas, So ratlier hurriedly, 
another LS-250 was sent. As it turned out, iliis 
one seemed to have a rather weak Panasonic 
battery. This sample, under battery backup 



conditions witli tlie Amiga A-1000 / Thomson / 
equivalent expanded computer system, lasted 
only 3 minutes, 18 seconds in the first in-use test 
and only 1 minute, 35 seconds in the second in- 
use test. 

This unit was returned to Kalglo and 
they replaced the battery. Sporting a new 
Power-Sonic 12 Volt / 6.5 ampere battery, the 
same unit was retested. It still performed poorly. 
The unit must have had some strange defect in 
its circuitry'. It started to have wild variations in 
its output voltage, after 1 minute, 30 seconds on 
battery backup. 

The LS-250 was exchanged for a 
current production unit. This unit w^orked quite 
well. Tlie second LS-250 lasted for 5 minutes, 58 
seconds in tlie in-use timed test. This was much 
more in line with the exp>ected results. Two 
seconds later, at 6 minutes, it came on again, 
with a wildly varying output voltage, and tlie red 
light finally came on. The design specifications 
state that tlie unit should last 6 to 11 minutes 
under full 250 VA load conditions. 

The strange, wild variation in output, 
and the unit lurning-on again was reported to 
Kalgio (in intimate detail). The designer of the 
LS-250 staled that what I saw was impossible. 
Their technicians spent several days trying to 
duplicate this variation in output and turn-on 
again, using the particular sample I tested and 
other LS-250's (reportedly without any success). 

Oh, well! Perhaps it was an anomaly 
of this particular test setup. When powering 
computer equipment, under real life conditions 
(except in cases of .someone tripping on the A.C. 
cord) the power plug would not be pulled from 
tile A.C. Maiiis, and the Ground reference would 
always be present. If the Ground reference was 
present, perhaps what I saw wouldn't have 
cxrcured. I think this is a very minor matter. 
Despite the problems encountered, I feel this 
unit's performance should not be significantly 
lessened. Overall, I have to admit they did a ver\' 
nice job designing it so small. List Price: $549.00 

SUMMARY: 

KALGLO LS-250 LINE-SAVER UPS 

Positive attributes: Many features, 
A.C. Wiring Integrity- Test, external battery jacks, 
test switch, alarm turn-off switch, small sized 
case, extended warranty. Excellent 
documentation. 

Negative attributes: Less than half the 
capacity and time reserv^e of odier similarly 
priced UPS units. Aluminum case, excessive 
heat generated during the high rate batter>^ 
charge, numerous warnings. Several problems 
with tlie first LS-250 unit tested. 
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Bored with Boards? 

You won't be after reading about ACDA Corporation's foray into the world of 

Data Aoquisition 



review by Lonnie Watson 

Flaving been around compulers lor a 
long time, I have had the pleasure 
witnessing many ways of getting real world 
daca into the computer. This process is 
called Data Acquisition, I have also seen 
many types of real world devices that were 
under computer control. Tliis type of 
interfacing is called process control. Quite 
often, botli t>pes of circuits are connected 
to the same computer for some purpose. 

Most computers have some form of 
data acquisition circuits, and process 
control circuits within themselves. 
Examples of this are serial ports, sound 
ports, disk driver chips, etc. But most often 
when an engineer wishes to create such 
things as compucerized alann systems or to 
control such things as sprinklers or lights, 
they must consider the addition of some 
piece of hardware to tlie standard 
computer in question. The Amiga, while 
being vastly superior to many computers 
costing more than itself, is no different in 
this respect. 

ACDA Corporation has released 
several products to help the hardware 
entiiusiast and professional engineer to 
develop various Amiga products tliat 
require data acquisition and process 
control. The main product in that line is the 
ACDA Proto 40K. The Proto 40K is a Data 
Acquisition and process control board for 
the Amiga 2X00 computer line. The board 
is a full length card with a female 25 pin 
connector protruding from tlie back. This 
connector provides various inputs and 
outputs for the Analog Data Acquisition 
unit. The review board was clean and free 
of any last minute hardware hacks. 
Towards the end of tlie board witli the 25 
pin connector sits a large black box about 
l/4th inch diick x 2.5" high x 4" wide. Tills 
impressive looking piece of hardware is the 
actual analog to digital converter. Irs is 
responsible for converting the real world 
information (in analog) to information tlie 
the computer can understand (digital). 

The list of feaaires for the Proto 40K 
is impressive they include: 



16 -12 bit analog to digital conversion 
channels (l6 bit channels are available as 
an option) 

2 -8 Bit digital to analog conversion 
ch:mnels 

16-1 bit digital input lines 
l6 -1 bit digital output lines 

3 -l6 bit timers (programmable and 
cascadable) 

3 -trigger sources for the A to D 
process 
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that the user writes. Some of the roLi tines 
are: 

p40_init; 

Used to initialize the p40 board. 

p40_setgain: 

Sets die amplifier gain on the analog 
input lines. Example gain settings are: xl, 
xlO, xlOO, and x500 settings. This feaaire is 
only available on some models. 
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The main screen of ACDA *s DigiScope software; a 

digital oscilliscope which may also be used in 

conjunction mth the Proto 40K board 



The board is also fuily autoconfigurable. 
That means tliat tlie Amiga autoconfig 
process detects the board and reserves 
some memory for the board in the Amiga's 
I/O memor^^ area. The actual memory 
reserved depends on what is also installed 
before die Proto 40K in tiie connector list. 
Each of tlie boards registers are dien 
accessed from diat base location in 
memory. 

The Proto 40K comes with a standard 
library of routines written in C. These 
routines can be freely used in any software 



p40_do/p40„di: 

Writes to the digital output and reads 
from the digital input lines. 

p40_dtoa: 

Writes the digital to analog lines 

Also contained in the C module ai*e 
routines to read the clocks that are on the 
card, open and close the Amiga timers, fill 
arrays with specific bit patterns as well as 
other useful programming tidbits. 

The card allows itself to be read in 
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AccelerOisk 

Get Reliable, Bootable 

Fast Floppy 

Access Now!!! 

Why wait for DOS 1 A7 

AcceterDisk uses Fast File 

System on all your drives 

to give you more storage, 

and speed increases 

of up to 5 times! 
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MJ SYSTEMS 
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Circle 176 on Reader Service card. 

two differeiu modes. The first of which is 
called random access mode. When 
operating the card in this mode you can 
very simply tell tlie card that you want to 
read data channel number 12 and tlien read 
data channel number 3 and then channel 
number 7 and number 1 and number 9--. 
well you get tlie picaire. The card also 
supports another, perhaps more useful, 
method of reading its data, this method is 
called sequential channel addressing. The 
basic way that it works is tiiat you tell the 
card what chamiel you want to start with. 
Then after ever>^ read the card will access 
the next channel in the sequence. All l6 
channels will be read automatically 1 
channel at a time. This configuration is 
perhaps better for a polled data collection 
setup such as a computerized weather 
station. 

The code samples that were included 
clearly showed several different features of 
the board put to practical use. While I was 
not able to test the board entirely I was able 
to make a few tests, concluding that the 
board was operating as it should be. 
Overall I found the Proto 40K to be a quality 
product that performed as it should under 
various situations. I have never seen any 



odier board that offers this level of 
accuracy and flexibility^ as found in tlie 
Proto 40K. 

Included with tlie Proto 40K board 
was a piece of soft^^are called Digi- Scope . 
This program allows the Proto 4 OK to be 
used to obtain, analyze and display real 
world data such as temperature, wind 
speed, water flow, just about amnJiing 
your heart desires. 

The program is fully configurable 
allowing all mamier of settings to bring the 
data into perspective. Once the incoming 
data is properly displayed you can 
perform various operations on it like 
signal measurement, obtain statistical 
information and run fast fourier transforms 
on the data for spectral analyses. The 
program is fairly complete and works well 
while being very easy to operate. The 
software will also work with tiie Proto 5K 
product from ACDA (a parallel port data 
acquisition unit for the 500/1000/2000/ 
2500 computers). 

Also included with my 

demonstration unit was another of 

ACDA's products called the ..AmigaGPIB 

(IEEE-488) interface board. This little gem 

is a general purpose board used to 

communicate and control various IEEE 

488 devices. For those of you out there that 

don't know what IEEE-48S is, suffice it to 

say that IEEE-488 reigns supreme in the 

engineering and laboratory environments. 

I had a plotter once from Hewlett Packard 

that was IEEE-488. (I sold it because I could 

not get it to work on my Amiga, sigh.) 

The AmigaGPIB card is a half card 
that will fit in any of tlie AMIGA 2000's 
expansion slots. I tested it in a 2000 and a 
turbo Amiga 1000 expansion chassis from 
CSA. in botli cases the card worked well. 
The card has a 24 pin header on it that you 
plug the supplied cable into. The otiier end 
of this cable terminates in a standard GPIB 
24 pin female connector. (It looks like a 
Centronics connector but is not as wide). 
This is an industry standard rEEE-488 
connection. The half card allow^s tlie board 
to be used in conjunction with any of the 
hard cards that are available for tlie Amiga, 
sparing a slot that was other^dse wasted. 
Communicating with the GPIB card 
was fairly striaght forward and cleady 
documented by tlie cards manual. The 
sofhs^are included with the card is in the 
form of a standard C scanned librar>^ The 
sofrt\'are contained the various makefiles 
that bring it all togetlier, as w^ell as many 
source demos to view* and learn from. The 
C scanned library contained all tiie 
necessary functions to read from and write 



to, die card and several iimctions to 
maintain tlie card and die devices on it. 
Also included are several routines to send 
specific commands to die devices 
connected to the card itself 

Overall I found the GPIB to be a 
quality product. The manual was clear and 
concise. The card itself w^as clean and free 
of tliose last minute hardw^are hacks tliat I 
have grow^n used to in the Amiga 
expansion markets. Two minor beefs witii 
the device (a reviewer has to pick on 
something don't diey?); the card's cable 
plugs nicely into tlie card itself but die odier 
end has noway to mount it on the machine. 
You have to remove the slot cover from the 
2000 then run tlie cable tlirough die slot 
and replace the slot cover, cinching the 
cable between the 2000's metal body and 
the metal slot cover. I am no engineer but 
I figure that plastic sandwiched betv/een 
two pieces of metal will eventually lead to 
trouble. You could always leave the w-ire 
dangling and not sandwich it between die 
plates but that looks messy and has otlier 
problems. (The cable disappears into the 
2000 and you have to take the whole 
machine apart-uggh!) 
The other minor beef is that the supplied 
soft^^are is in C format. I for one do not like 
to program process control in C and I feel 
that many odiers do not like to do so eitlicr. 
There are many other languages that are 
better suited for the task than C (Forth for 
one). The software should be in the 
standard .libran^ form that way even Amiga 
BASIC could take advantage of the unique 
features of these two pieces of hardw^are. 
Granted diese are minor beefs. It is fairly 
easy to create a better mount for the cable, 
and the C problem can be w^orked around. 
Like I say reviewers have to pick on 
something. 
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ACDA Corporation 

220 Belle Meode Avenue 

Setauket NY 11733 

(516)689-7722 

Proto 5K. $279.95 
inquiry #213 

Proto 40K board, prices vary 
inquiry # 214 

DigiScope.S 139.95 
Inquiry #215 

AmigaGPIB board. $495,00 
Inquiry #216 
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STARSHIPS 2050 



A Snip-It by 
Mike Morrison 



STARSHIPS 2050 is a three-disk librar>^ of 3D models including starships, moon bases, fighters, satellites, and one disk full of digitized 
NASA photographs (HAM or 32 colors) that can be used as backgrounds. They are designed for use with other modeling and 
animation software such as Sculpt Animate 4D or Turbo Silver. These 3D models can be used as company logos, special effects in 
videos, or to create animations. 

STARSHIPS 2050 is available from Polar Arts Software, 14145 Janna Way, Sylmar, CA 91342 Phone: (818) 362-8565. A short demo is 
available on VHS videotape. The demo shows some of the objects being used in various ways, including animations. STARSHIPS 
2050; $49.95, STARSHIPS 2050 VTiS demo videotape: S9.95. Please circle #217 on Reader Service card for more infonnation. 
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Learning the Hard Way 

The frustrations of upgrading your AlOOO 



by Phil Saunders 



I had finally reached the stage when 
I needed a hard drive. The stacks of flop- 
pies on my desk climbed higher and 
higher, and the disk I needed always 
seemed to be at the bottom of the pile, I had 
even managed to hoard enough money to 
pay for a hard drive. There was only one 
problem — I have an Amiga lOCX). 

That doesn't sound like an insur- 
mountable problem, but it caused me 
trouble to no end. I wanted an Amiga 2000 
(and a 68030 board, and a flicker Fixer, and 
a...), but I couldn't afford to spend S2000 
and then buy a hard drive. I w^anted to get 
the hard drive now^ and buy my A 2000 
once I won the lottery. So I didn't just want 
to get a drive made for the AlOOO; I wanted 
one that would also work on an Amiga 
2000 system. 

Making A Decision 

I considered a variety of options. I 
could buy the Microlx)tics SCSI adapter 
w^hich would fit in my StarBoard 2 memory- 
expander. But this would require buying a 
case and power supply for the hard drive, 
and I had heard that the Microbotics SCSI 
port was fairly slow. I could buy an AlOOO 
specific system, but AlOOO drives tend to be 
more expensive, and I would have to throw 
away the interface when I upgraded to an 
A2000. Just when I was about to give up, I 
heard about the Toolbox. 

The Toolbox is an expansion box for 
±e Amiga 1000 that allows the AlOOO to use 
Amiga 2000 cards, I talked to Expansion 
Technologies, which distributes the Tool- 
box, and it sounded like an ideal solution. 
I could buy Amiga 2000 cards and use them 
with the Toolbox until I saved enough to 
buy an A2000 of my o\vti. I promptly 
ordered a Toolbox and a GVP hardcard 
from Go Amigo. After a week they arrived, 
and I set up the system. 



At first, I wasn't impressed witli the 
Toolbox. It consisted of a long metal chas- 
sis which contained the power supply and 
the two Amiga 2000 slots. It connected to 
the Amiga via a bus connector and passed 
throught the bus on the other side. The 
connector was slightly crooked in relation 
to the chassis and the soldering wasn't very^ 
neat. In addition, the holes on the metal 
cover didn't quite line up with the holes in 
the chassis. Still, I could live with these 
flaws if it worked. 

Plaguing Problems 

Unfortunately, it didn*t. Tlie CAT 
software was unable to communicate with 
the Quantum drive. It would try to format 
and then sit for hours without doing any- 
thing. I called Expansion Technologies, 
which said they had some reports of people 
having problems with the GW hardcard. 
They were working on a fbi, but they 
recommended that I trv the Flash Card, 
their SCSI controller which they guaranteed 
would work with the Toolbox, I considered 
my options and decided that a system that 
worked now was iDetter than a system that 
might work later, so I mailed back the GVP 
card and waited two weeks for my Flasli 
Card and Quantum hard drive to arrive. 
Once it did, I installed the card into the 
Toolbox, powered up, and expectantly 
started the formatting software. Nothing. I 
tried editing parameters for the formatting 
software, but nothing worked. 

Now Expansion Technologies 
thought the Flash Card might be bad, so 
they sent me another one. One week later 
I still had the same problem. Well, the drive 
might be bad, so I sent them the Flash Card 
and the drive, and one week later I got a 
call. They had reset some jumpers in the 
drive (the Flash Card manual said nothing 
about jumpers), and it still wouldn't format. 



They ended up formatting tlie drive with a 
G\T controller; once it was formatted it 
worked fine on the Flash Card. 

I was a little ner\^ous about owning a 
drive I couldn't format, but I decided, if it 
worked, I could live with it. I installed the 
card in the Toolbox, powered up, and tried 
a high level format. It worked! For two days 
I w^as using my Starboard 2 between the 
Amiga and the Toolbox (the computer 
wouldn't boot with the Starboard 2 on the 
Toolbox's pass through). I noticed that 
some programs would crash my system 
immediately. The strange part was that it 
didn't matter if I ran the program from the 
hard drive or from a floppy. If the prograin 
used a custom screen, it crashed about half 
the time. Sometimes I got Gums, and 
sometimes my display showed a screen of 
constantly changing static. And, eve mime 
I tried a soft reboot (Control-Amiga-Amiga) 
I lost Kickstart. 

Expansion Technologies recom- 
mended trying new PAL chips, so I ordered 
a new set of PALs from C Limited. I carefully 
desoldered the old ones, installed sockets, 
and put in the new PALs. Now the com- 
puter wouldn't boot at all. Uh oh! One 
hundred dollars and a (240 mile) trip to the 
repair shop later, I learned that the replace- 
ment PALs were defective. The repairman 
had replaced the C Limited PALs with stock 
chips and the computer booted right up. 

I eventually discovered that the 
Toolbox and Flash Card worked if I didn't 
use my Starboard 2. But then I only had 
512K, and a system that lost Kickstart 
everytime it crashed. That wasn't good 
enough, especially since Expansion Tech- 
nologies said that the Toolbox would work 
with the Starboard 2. Incidently, if I tried to 
use Kick bench 1.3, the Flash Card would 
not work at all. I also discovered that if the 
Toolbox was loosely connected to the 
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Fast, Compatible, Complete! 



m Two high speed RS-232C serial ports for the Amiga 2000. • 
IBM PC AT style (full 7 wire plus Rl and DCD) connector for 
each port. • Send and Receive at 110 to 115200 baud. • 
Complete Amiga system software (both Exec and DOS). • 
Using our exclusive Serial Dispatcher, any program which 
uses "seriaLdevice" can use any port without patches. # 
Public domain and shareware software on the distribution 
diskette. • One year warranty. 

ASK YOUR DEALER! 

925 Stewart Street 

Madison, Wl. 53713 

(608) 273 - 6585 



ASDG 

Incorporated 



Amtga Is a Iredemait o1 Commodore-Amiga, lnc> IBM PC AT is a trademark of IBM Corp. 
Circle 112 on Reader Service card. 



Starboard 2's bus, the system would work 
most of the time. I suspect that the crooked 
connector on the Toolbox may have been 
the source of the problem, bin by this point 
rd had enough. I sent the Toolbox and 
Flash Card back to Go Amigo and slept 
soundly for the first time in months. 

A lesson Learned 

I have never experienced a problem 
more fmstrating then trying to get the 
Toolbox to work on my Amiga. Expansion 
Technologies' service department was 
always friendly^ but after three months, 
they still weren't able to get the Toolbox to 
work on my system. 

What lessons can be learned from my 
experience? 

1. Shop locally if possible, especially 
if you are dealing with new technology. 

Unfortunately, there aren't any Amiga 
dealers within 200 miles of me, so 1 couldn't 
follow this rule. One of the most frustrating 
things about the ordeal was that everytime 
something went wrong it took t^^o weeks 
to ship the part to California and back. A 
local dealer might have been able to ex- 
change parts on the spot; they also might 



have been able to try the Toolbox on 
another system. 

2. Don't be the first to try a new 
product. There's a saying in the computer 
industry that you can tell the pioneers, 
because they're the ones with the arrows 
sticking out of dieir butts. If you are the first 
one to try a new product, guess who gets 
to discover all the initial bugs? 

3. Use a stock system. I thought that 
the problem must be w^ith the Toolbox 
because my Amiga crashed when I had the 
Toolbox connected directly to the Amiga. 
Later I discovered that the Toolbox/Flash 
Card wouldn't work with KickBench 1.3- 
Once I quit trying to use KickBench, the 
Toolbox worked fine. 

4. Isolate the problem. The best way 
to diagnose a problem is to find out what 
is not causing it. As Sherlock Holmes said, 
**Once you eliminate ihe impossible, what- 
ever is left, no matter how improbable, 
must be the explanation," I should have 
tested the system with just the Toolbox and 
stock Kickstart much eadier than I did. If 
there are too many variables, it is hard to 



discover exactly what is causing the prob- 
lem. 

5. Consult the Experts, Bulletin 
boards, customer sen" ice departments, and 
friends with degrees in Electrical Engineer- 
ing can all be good sources of advice. Very 
rarely will you find a unique problem. (My 
case is the exception that proves the rule.) 

6, Deal with companies you can tmst. 

Since 1 wasn't able to work with a local 
dealer, I had to work by mail and tele- 
phone. Go Amigo was willing to exchange 
my GV? board for a Flash Card, and even- 
tually gave me a complete refund. C Lim- 
ited refunded the money I spent on the 
defective PAL chips. And even though 
Expansion Technologies didn't solve my 
problem, they did go out of their way to try 
and help me. When something really goes 
wrong, you 11 be glad you are dealing with 
reputable people. 

As you can tell, my experience with 
the Toolbox was unsuccessful. I'm not 
claiming that the Toolbox won't work for 
anyone, but 1 do advise caution before 
trying it. There are some significant differ- 
ences between Amiga 1000 and Amiga 
2000 bus signals, and in my opinion, the 
Toolbox does not do enough to solve these 
differences. The Amiga 500's bus signals 
are much closer to the A2000 standard; I 
have heard that the Toolbox for the A500 
works better than the A 1000 model. What- 
ever you decide, keep these six points in 
mind when dealing with expansion prob- 
lems. 

And me? What did I decide to do? I'm 
saving for an Amiga 2000 with a Fat Agnus, 
ril get a new computer, and then maybe I'll 
start thinking about getting a hard drive.... 

•AC' 
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(Snapshot, continued from page 18) 
that aaively seek out and destroy en- 
cro:iching vessels. Worker patrols are two 
or four u^orkers who are constantly con- 
structing new bases and linkages. Several 
allied resupply bases are scattered around 
the area to allow you to quickly restore the 
limited stocks on your personal submarine. 
Since they are so valuable, warrior patrols 
actively seek them out, and you must be 
careful to protect them or one of your 
resupply sources may be destroyed, 

The game is a race against time. 
While you are destroying his linkages, 
bases and patrols, the Yellow Shadow is 
actively building more. Whoever is more 
efficient will win the day. Tlie game ends 
when either your submarine is sunk, or the 
Yellow Shadow has mined the required 
amount of unraniun. 

Oameplay centers around the sub- 
marine viewport, a three-dimensional view 
out the Iront of the vehicle. Tlie underwater 
view is very good, witli rocks and mines 
shown in full color and with apparent 
depth. Two other screens are used during 
play. Tlie map screen shows an overhead 
satellite view of the whole situation, allow- 
ing you to develop your plan of attack and 
set your autopilot. The third screen, the 
diving screen, comes into play when you 
leave the submarine and aiiemi:)l to destroy 
the connecting linkages. You must sv/im 
through sev^eral screens of underwater 
scenery to the linkage, plant an explosive 
charge, and then swim back to the ship. 

The game features three difficulty 
levels. The lowest level begins with a faidy 
small network in place and features very 
few underwater patrols. The other xwo 
feature more developed starting nerw-orks 
and more patrols. These levels help to 
prevent the game from becoming too ea.sy. 

The joystick and keyboard are used 
for all control during the game. While this 
wfjrks fnirly well, it can he :i bit diffic*ult to 
toggle lx:ftween the keyboard and joystick 
during particularly active times. 

Unfonunately, the game is fairly easy 
to master. While it d\d take me several 
hours, 1 did manage to win a game at tlie 
highest level after only one night of play. 
Still, the potential for replay is there, and I 
could easily see myself coming back to the 
game in a few weeks to try and save the 
world once again. Should be worth your 
while. 

Gauntlet 11 

Next on tlie list is a conversion of 
another arcade classic from Mindscape. 
Gauntlet 11 is a continuation of the theme 



begun in the original Gauntlet. Our favorite 

characters, the Hlf, the Valk^Tie, the Warrior 
and the Wizard, once again face the chal- 
lenging depths of a new series of dungeon 
levels. 

Far from simply a series of new floor 
plans, Gauntlet II adds several new features 
not found in the original. Instead of being 
assigned a character, each player can now 
pick their class. Thus we can see games 
widi four warriors, two wizards and two 
elves, or any odier desirable combination. 

The mazes are also all new. Over 100 
new levels are included in the package and 
should offer many hours of playtime. In 
addition to the static and destroyable v^ails 
of the original, these new levels may have 
invisible walls, walls that move, and even 
some that can be shot to reveal good or bad 
surprises for our adventurers. 

Other new features have also en- 
hanced gameplay. At the deeper levels, 
one of the players "will be tagged as "it". 
This tends to draw all die monsters toward 
die tagged player. But with a little cooj>era- 
tion and teamwork, this feature can be used 
to quickly eliminate the many pesky deni- 
zens of the dungeon. New powers, such as 
reflective shots and repulsiveness, are 
available at various spots, and chests can be 
opened to release items for party use. 

The graphics in Gauntlet II are veiy 
.sharp and enjoyable, rivaling those found 
on the dedicated arcade version. Scrolling 
is how it should be — very smooth and faidy 
unnoiiceable. The sound is also fantastic; it 
can bQ great to hear a voice announcing 
that "Red Warrior now has reflective shots", 
or devastating to hear the slow countdown 
to death as a character's healtli slips away. 

With a special printer port adapter, 
the game can be played by up to four 
people at a time, making for a very enjoy- 
able way to get others involved in this 
action-filled game. I enjoyed the game ver^^ 
much and it is sure to be at the top of my 
list for some time to come. 

Deja Vu II 

Finally this month I would like to take 
a brief look at Oeja Vu 11, lost In Las Vegas, 
by Icom Simulations. This is one of the few 
graphical text adventures to be released 
recently. 

You have been abducted by t^^'o 
thugs from Chicago, grilled by a notorious 
Las Vegas mob.ster, and knocked senseless 
and tossed into a tub in a sleaz)^ motel 
room. You now must figure out where to 
go from here. 

The mouse is used to control almost 
all action in the game. You can move, 



iaspect and use items, and perform nearly 
any other action by either clicking on Uie 
item itself or selecting from the simple 
action word li.st available at the top of the 
screen. 

The graphics are well drawn, The 
visual clues in the pictures fill in where you 
would have formerly needed a "look" 
command. 

Despite this supposed "ease of use", 
I found the game fairly frustrating. Disk 
access slowed down movement and it was 
sometimes difficult to know exactly how to 
perform a desired action. Vnv example, I 
was trying to put my lucky quarter in the 
slot machine, but for some reason I could 
not locate the slot for the quarter to go in. 
I kept dropping the quarter on various pans 
of the machine, but the quarter would ju.st 
sit there. This was very frustrating. 

In case you haven't gue.s,sed, I am not 
a great fan of this form of entertainment 
anyway, but 1 thought I would givt^ it a tiy. 
As I had several years back, 1 found tlie 
medium limiting (even though it has been 
augmented by many pretrs^ pictures), and 
therfore cannot recommend Deja Vu II. 

That wraps things up for this month. 
Look for my list of special picks foi- the 
Christmas issue. See you then. 

•AC- 
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The Command Une 



Since the Amiga's inception, die wiz- 
ards at Commodore have worked hard to 
improve the operating environment. Many 
would argue that most of the Amiga's 
success is owed to the plethora of programs 
available commercially and in the public 
domain. The side effect of this abundance 
of software is that it is virtually impos- 
sible — and generally undesirable — to 
download everytliing dial looks interest- 
ing. Most of us certainly carmot afford to 
buy everything we want. We have to make 
choices. 

Part of what I hope to accomplish in 
tiiis column is to give you a source of 
detailed inf conation that will make your 
choices easier. One of these choices is a 
system upgrade offered by Commodore, 
What is an Enhancer package and do you 
need it? There are a lot of Amigans who are 
wondering right now, "Why in tlie w^odd 
wouldn't you upgrade?" Initially at least, 
this can be treacherous territory^ especially 
for new users. I will examine the new fea- 
tures provided by the AmigaDOS 1,3 En- 
hancer software package, trying to explain 
in simple terms what it means to you, the 
Amiga user. But, before I get staned, allow 
me to shed a litde light on die subject of 
operating system trKes and improvements. 

Commentaty 

Many have faulted Commodore for its 
lack of vision and lediargic response to 
market needs. The constant changes in 
management diere often leave analysts 
wondering who's in charge. The obscure 
advenisement accompanying tiie ma- 
chine's introducUon nearly sounded its 
deadi toll before it was ever out of the box. 

But let's stop long enough to contem- 
plate die massive effort diat goes into the 
development of a poweriiouse like the 
Amiga, This was the firsc personal com- 
puter to offer an environment for die nov- 
ice and the expert alike. I challenge you to 
find a si milady priced machine with the 
graphics, sound, command stmcmre, con- 
figurability, and flexibility that die Amiga 
has. 



And ^4iy do you suppose eveiybody 
is jumping on the multitasking band- 
wagon? Because diose who have had a 
taste of it loathe the diought of returning to 
the restricUve single-process, single-use 
environment. Just look at some of die 
advertising for die MS-DOS-compatible 
market. You will find piles of — let's see, 
what's tliat term? Ah, yes^ — ^TSR programs, 
many of which are incompatible with each 
other. What is a TSR program? Why, it is a 
Terminate and Stay Resident program, of 
course. Now where have I heard of diat 
before? Oh, I remember. The first programs 
of this nature which I encountered were 
nifty utilities that I used witii my Commo- 
dore 64, long before die term "PC' took on 
the assumed connotation of 'IBM-compat- 
ible." What kinds of programs are these? 
Oh, simple things like calculators, clocks, 
address and phone number keepers, ap- 
pointment reminders, calendars with 
notes, and printing utilities that allow you 
to print in die background while you con- 
tinue to use the computer. So, even though 
we occasionally complain, we should take 
time to reflect on where we have come 
from and what we often take for granted. 

In spite of mmors to die conlraiy , the 
AmigaDOS operaUng system has been a 
fairly stable environment since version 1.1. 
Sure, there have been some nagging prob- 
lems and even outright omissions, but 
don't diink for one moment tliat Commo- 
dore is alone in this area. After all, DEC'S 
VMS operadng system is up to Version 5, 
and UNIX is up to Versions 3 and 4. Each 
new version offers greater stability and 
utility tlian die one before it, while bugs are 
usually fijced with each new release. We get 
new toys to play widi, irritating problems 
are usually fixed, and improvements to 
commands and utilities that have become 
old friends give die machine we know and 
love a more comfortable environment. 

Why doesn't Commodore fix things 
more often? The reason is that it is a monu- 
mental task to ensure that the fixes don't 
make old software obsolete or conflict with 



by Rich Falconbiirg 



new additions. It takes a careftilly orches- 
trated effort on die part of everyone in- 
volved to ensure a stable environment for 
fLiture development. 

Yes, diere are a lot of nifty programs in 
the public domain which, as you will see, 
do much of the same thing that the 1.3 I''n- 
hancer package does for the Amiga. 
However, not evtriyone has 'M\ t'ss to -or 
even knows about — PI) progj-.ims :*s an 
alternative. Many people I have talkc'd to 
do not realize that there is mort* than what 
their dealer provides for ihem- Avhicli, as 
you may have guessed, is generally only 
die "official" addidons j^rovided in the 
package marketed by the parent com p; my. 
Commodore missed capitalizing on some 
golden oppoiTunities. We are the winners. 

Okay, philosophy cla.ss is dismissed. 
Now on to the "New and Impnivt^d" Ami- 
gaDOS. 

Uje Enchanted Forest 

The AmigaDOS 1 .3 Enhancer package 
comes complete with three disks and 
documentation to get you started. I-irst. let's 
take a look at some of the new feiitures. .\^ 
you may know, one of my pet peevc\s about 
die Command Line Interface was the mis- 
erable line editing in a CLI window. .^ 
feature diat greatly improves the CfJ is the 
AmigaDOS Shell. This is a console window 
that may be started with the NEWSIIKIX 
command and uses a handler with .several 
ne^^ capabilities. .Among the features pro- 
vided by the Shell are usable editing key 
combinations. The delete key wiil era.se the 
character under the cursor, im6 the arrow 
keys may be used to move back and forth 
on a line, or lo scroll through the command 
history. Control sequences add even more; 

CTRL-K Deletes from the cursor to the end 

of the line. 
CTRL-U Deletes from rhe cursor 'o -he 

star^ of the line. 

CTRL-X DeleTies nhe entire line. 

CTRL- A Move to the start cf the line U^lso 

SHIFT-**) . 
CTRL- 2 Move to the end of the lin^ (also 

SHIFT-iE) . 
CTRl-K Move tc the next tab stop. 



Amazing Computing V4:ll ©1989 



53 



Meet a team of the friendliest 
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A^hen you want to manage your personal finances. Money 



Mentor goes a step beyond. 
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obtainable today! 
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• 20{1 Budget Clategories 
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• Automatic Check frinting 

• Automatic Account Balancing 
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• Over SO Repons to chiMJsc from! 

VHiat they're saying about us! 
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Money Mentor is for everyone! 

It does more than just keepytuir checklxnik txilanced, Money Mentor helps you 
manage your perM»nal finances which is imponant to any family or individual. 

Vt (th Money Mentor, you can Ix* liniking better Rnajicially 

Order .Vtonrv Mentor todav 
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Additionally, you may use CTRL-R (or 
SHIFT- ) to search for a previous com- 
mand and recall it. For example, if you 
entered a lengtliy path for botli the source 
and destination of a copied file, and you 
have need to use the same path witli a 
different file, enter COPY and press CTRL- 
R (or Shift- ). The first occurrence of COP Y 
which is found is displayed complete with 
the entered text. Simply edit the line using 
the arrow keys and press RFFURN. If you 
wish to move to the bottom of the history' 
buffer, you can use CTRL-B (or SHIFT-0), 
This is handy when you have stepped 
through several entries and decide to skip 
it and re-enter the command. 

Also Known As. , . 

The other enliancement provided by 
the Shell is the adduic :i of aliases. This 
allow^s each user to create alternate names 
for procedures and commands. Since 
parameter substitution is supported, it is 
possible to defme an alias for a variety of 
command-option combinations. 

For example, you may like the infor- 
mation provided by the LIST command, but 
prefer to display things differently than the 



default provides. This., of course, requires 
the use of one or more options on the 
command line to modifv^ the output. By 
using an alias, it is possible to assign this 
command string to a ''variable," which may 
be entered instead of the entire command 
string: 

1> ALIAS nf LIST SINCE [] 

To use this you would then enter 

1> NF TODAY 

or 

1> NF 3- JAN- 8 S 

Here I have defined the alias "nf ' to mean 
the same as "LIST SINCE"; the brackets tell 
the Shell to pass the qualif^^ing date pa- 
rameter to the LIST command. Its ven^ 
similar to logical assignments with an 
added twist. 

Please note that the method shown 
above is the correct w^ay to defme an alias. 
The documentation show's quotation 
marks around the command string, but if 
you enter them as show^n you will receive 
an error message when used. 



To erase an alias definition enter; 

1> ALIAS name 

where "name" is the definition name used 
when the alias was created. Keep in mind 
tliat each Shell window is a separate entity. 
This means that an alias defined in one 
Shell window will not be available in the 
others. The exception to tliis is a special 
startup file that is executed each lime the 
NEWSHELL command is used. This file is 
located in the S: director)^ and is called 
Shell-startup. If you want your alias defini- 
tions to be available in every Shell window, 
place them here. 

Commodore has provided several 
useful aliases as examples. One of these 
has been defined as shown below; 

ALIAS ren EXECUTE S:DPAT RENA.ME [J 

DPAT and a companion file, SPAT, are 
what could be called "w^ork-arounds" to the 
clumsy pattern matching of certain -\miga- 
DOS commands. These script files may be 
used with other commands to allow single 
argument (SPAT) and double argument 
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(DPAT) pattern matching. This allows you 
to do wild card operations with those 
commands that normally won't tolerate it. 
I'm not going to get into the intricacies of 
what these "work- arounds" entail, but I do 
need to introduce a few diings for you to 
dig around in and get comfortable with. 
Commodore's solution to some of the 
shortcomings of other commands was to 
add some significant features to the LIST 
command, and to use it in re-direction and 
variable substitution. Tliis is a whitewashed 
description of these two script files; I have 
only scratched the surface. 

We also now have "environment vari- 
ables," which may be used to establish 
specifics used by various script files. Unfor- 
tunately, you cannot simply include this 
variable as part of a command line. Why? 
Because they cheated. An AmigaDOS 
environment variable is a text file that has 
been defined and placed in a special direc- 
tory in RAM. Access to said variables is 
through two new commands: SETENV and 
GETEN\^ 

But wait, it gets even better! They have 
also assigned the logical ENV: to this direc- 
tory, which means tliat if you try to delete 
the directory to save memory, you will dis- 
cover that it won't let you. You must first 
erase the assignment with: 

1> ASSIGN ENV: 

Now you may delete the dii'ectory and its 
contents. (There are some things that are 
kept here which I will discuss later.) The 
documentation leads us to believe that this 
is a [emporar^^ kludge and tliat a handler 
will eventually manage variable manipula- 
tion. 

The other directories that are new to 
this environment are RAM: CLIPBOARDS 
and RAM:T, Bodi of these have logical 
names assigned to tliem as welL Remove 
this assignment with: 

1> ASSIGN T: 

1> ASSIGN CLIPS: 

Now you may delete them if you wish. An 
easier way would be to "comment out" the 
creation and assignment statements in the 
S:StartupII file. (Don't rush me: I'll explain 
that file in a moment.) Before you delete 
the T: directory and assignment you should 
know that this is now used correcdy by the 
EXECUTE command for script file substitu- 
tions, and will make a big difference in the 
execution speed of these files. 



There is a new Startup-Sequence in- 
cluded with your W^B 1,3 enhancements. 
Among other things, this file now calls a 
new file designated StartupII. The reason 
for this is diat a special file is made RESI- 
DENT by the original starmp file. To allow 
subsequent commands to make use of tliis 
new capability, you must use a new CLI (or 
Shell). Several things are accomplished in 
this new startup file — including making a 
number of commands RESIDENT — which 
also help to speed up the booting process. 
Several of these are then removed from tlie 
RESIDENT list to save memory, with com- 
ments recommending that you leave the 
commands in if you have the memory for 
them. Truthfully, unless your command 
director}^ is still on a floppy disk, this is not 
really helpful. 

If you examine the moundist file 
found in the devs; directory, you will notice 
entries for several new devices. One of 
these is NEWCON:, the new console han- 
dler device used by the AmigaShell win- 
dows. Others include SPEAKER: , a narrator 
device that presumably allows speech to be 
easily incorporated into programs, and 
PIPE:, a device diat allows output from one 
program to be sent to the input stream of 
another program. We will investigate all of 
these — ^and also the RAD: recoverable RAIvI 
Disk — in greater detail in future issues. 

The AmigaDOS 1,3 Enliancer software 
package adds signifi candy to die existing 
environment. Implementation of several 
features seem shabby and shortsighted 
and — considering the delay in getting it to 
market — not quite complete. There are, 
however, several significant additions and 
improvements, including Auto-booting 
and tlie Fast File System, which make it an 
attractive addition to the basic Amiga sys- 
tem. If you have not already invested in this 
upgrade, I recommend that you give it 
serious considerauon, if only for the latter 
features alone. In future issues I will look 
at ways to make the most of the new 
commands and devices, while we learn 
together how to use tlie power and capabil- 
ity of a machine ahead of its time. 
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War In 9SMCc "Earth 



revietv by Rich J, Grace 



Since J.R.R. Tolkien's epic trilogy, 
The Lord of the Rings, first achieved its vast 
popularity rwo decades ago, rniliions of 
imaginations have been captured by the 
work: by its acute and entertaining charac- 
ters, its tightly controlled and deeply 
moving prose sr^^le, and, most of all, its 
depiction of an elemental conflict of good 
versus evil and the great suspense that 
results: 

'"Old fool!' he said, 'Old fool. This is 
my hour. Do you not know Death when 
you see it? Die now and curse in vain!' And 
with tliat he lifted his sword and flames ran 
down tiie blade. 

Gandalf did not move. And in that 
very moment, away behind in some court- 
yard of tlie City, a cock crowed... And as if 
in ans^wer tliere came from far a^way an- 
ottier note, Horns^ horns, horns. In dark 
MindoUuin's sides tliey dimly echoed. 
Great horns of the North wildly blowing. 
Rohan had come at last." 

So powerful is tliis work that almost 
four decades after it was published, The 
Lord of the Rings sx}X\ looms as die towering 
classic of its field, as the work against which 
all odiers must be measured. An entire 
publishing industry has spmng up to sup- 
port the brief Tolkien lexicon, consisting of 
commentaries, calendars, maps and trave- 
logvies, and linguistic dictionaries. Further- 
more, 77je Lord oftheRifjgs is xii.e only work 
in its field tliat sustains dramatic tension 
and literary control through the course of 
an entire trilog>^, stretching over a diousand 
pages. 

Any reader who has yet to discover 
the work is in for an enviable treat. A treat 
scarcely less exciting is the prospect of a 
full-color, animated computer game based 
on the Tolkien classic. The game, of course, 
is War In Middle Earth 

War In Middle Earth encompasses 
the entire scope of the Tolkien trilogy, and 
allows the player to roam at will over tlie 
topography of Middle Earth. The object of 
the game, as is the aim of tlie protagonists 
in the books, is to destroy the Ring of 
Power. The Ring is a magical item of greai 
evil power, which is the vital foundation of 
die powers of the great adversaiy in the 



books and the game — Sauron the Great. 
The Ring is of such power tliat there is only 
one way to destroy it: to drop it into the 
volcanic fissure of Mount Doom, where it 
was forged. 

"Three Rings for the Elven-Kings 
under the sky, 

Seven for the Dwarf-lords in their 
halls of stone, 

Nine for Mortal Men doomed to die, 

One for the Dark Lord on his dark 
throne 

In the Land of Mordor where the 
shadows lie. 

One Ring the rule them all, One Ring 
to find them, 

One Ring to biing them all and in the 
darkness bind them 

In the Land of Mordor where the 
shadows lie. " 

Unfortunately, Mount Doom is lo- 
cated at the hean of Sauron's evil realm, in 
the center of tlie plain of Mordor. At the 
beginning of die game, as in the books, the 
ring is not in Sauron's possession, but is in 
tlie hands of a young and innocent hobbit 
by tlie name of Frodo Baggins, whom with 
scant help must leave his remote home of 
die Shire to make his tortuous way to 
destroy the Ring. From the beginning, his 
journey is perilous, for the Adversary has 
sent out his nine evil lieutenants, tlie 
Nazgul, in search of the Ring. They have 
virtually surrounded the Shire at the begin- 
ning of the game, and haunt the roads East. 

Game Mechanics 

War In Middle Eartii consists of three 
levels of interaction: an animation level, at 
which ail combat scenes and character 
interaction takes place, and two strategic 
levels. Levels 2 and 3 are both representa- 
tions of the map of Middle Earth. Level 2, 
however, is a rasterized map of 36 square 
Amiga screens, over which tlie player 
scrolls to explore any part of the landscape. 
The scrolling is crisp and seamless. Level 3 
is an overall one-screen map of Middle 
Eanh, with several ganie-managemenc 
icons in the top right corner, one of which 



allows you to save the game in progress. 

The maps conform accurately to die 
true maps of Middle Eartli. The tme pleas- 
ure in Level 2 is in its highly efficient 
magnification icon tool which, when 
placed over any location of interest in tlie 
Level 2 map and clicked upon, brings up a 
detailed graphic image of the place of 
interest, often with animated figures mov- 
ing across the screen, and with sound 
effects and musical accompaniment. Many 
of these screens are astonishing in their 
beauty. The system comes as close as we 
may ever see to a visual representation of 
Middle Eanh. 

According to sources at Melbourne 
House, many of the graphic screens in the 
game were digitized (using Digi-View), 
using a specific color palette assigned to 
each picture to ensure uniformity in Lhe 
coloring formats. Dithering techniques 
account for the grainy, realistic aspect of 
many of the saeens, and for their almost 
liAJvl -seeming effecLs. 

If die player is exploring during the 
course of a game, he or she will be 
prompted whenever anydiing of impor- 
tance is about to happen on the animation 
level. 

The player may opt for diree speeds 
of play during the game: Normal, Hasty, 
and Ver>^ Hasty. To execute a quick game, 
however, is to eliminate much of the tex- 
ture and detailed interest of tlie game. Widi 
many of tlie more tense segments of the 
game, it is advisable to play them in Normal 
speed, to gain the full measure of tlie 
game's strategic dimension. Large battle 
segments will also not be displayed in the 
Hasty modes. 

For the first segments of the journey, 
no help is available except from a few 
fellow hobbits who join Frodo on the 
journey. Their names are familiar to any 
Tolkien reader. Beyond, however, die 
character of Aragom, a powerful fighter 
and one of die most inspiring characters in 
the books, awaits the chance to aid in die 
journey. 

In tlie course of the game, the char- 
acters will pass by numerous animated 
characters, such as fellow hobbits. 
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dwarves, men, and what appear to be 
wizards with high-topped pointed hats. 
Most of tliese are not communicated with in 
the course of the game, and pass by si- 
lently. When an important character ap- 
pears, however, die game will prompt die 
player either to join in conversation or to 
pass on. These characters will often have 
useful information to offer, such as the lo- 
cation of a magical weapon or other objects 
that may be vital in tlie campaign. 

Aragom is usually die first important 
character tlie player runs into. It is wise not 
to turn him away, for the hazards are far 
greater tlian a small band of hobbits can 
deal with. The first destination for the small 
party is the town of Rivendell, wliich lies 
directly east. Here, if the Nazgul are de- 
feated in the inevitable battle at the river 
crossing, die rest of the party, with all the 
characters familiar from the books, is as- 
sembled. The main stage of die journey and 
the game then begins. 

The Strategic War 

War In Middle Eardi does not empha- 
size the interactive aspects of many role- 
playing fantasy 
games. Nor is 
there an extensive 
interactive com- 
bat system. WIME 
(pronounced 
Why Me) is a stra- 
tegic contest. Not 
only must the ring 
be brought to 
Mount Doom; the 
various and scat- 
tered forces of 
good must be 
roused to action 
and made ready to 
fight against tlie 
evil invasion soon 
to come. 

Single and 
group combat 
scenes are 

handled on the 
animation level; 
and even though 
player responses 

are basically limited to four options 
(Charge, Engage, Retreat and Flee), die 
animation is well handled and many of the 
combat scenes are exciting to watch. 

Inherent in tlie whole process, of 
course, is the excitement of seeing the 
entire War Of The Ring scenario under 
personal control. Many options are avail- 
able to the player in tliis comprehensive 
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rendering of tlie Ring scenario. The player 
may choose to follow the exact path of the 
Company (Gandalf, Aragom, Frodo, and 
all tlie rest) to the destination of Mount 
Doom. A possibility that is suggested in the 
game manual (wliich, by the way, is well 
written, and provides almost ail the impor- 
tant facets about the game) is to travel to all 
tiie various enclaves of Good that Frodo 
never visited in the books to raise their 
armies in the defense of Condor. To be fair, 
this does occupy a large amount of game 
time. 

Wlmt You're Up Against 

While the Company is complete, it is 
quite powerful. Packs of wolves are easily 
dealt with by die sword without involving 
the hobbits in combat. However, a shadow- 
stalks the Company — namely ±e bmtai- 
ized, stunted figure of Gollum. The player 
can easily feel sorr^^ for this poor fellow as 
he limps across the landscape, an agonized 
look on his face, widi his little tongue 
hanging out. He is more interested, how- 
ever, in the Ring Frodo carries than in 
anydiing else in Middle Earth. This is al- 
ways a factor to 
consider. Fur- 
thermore, if die 
party passes 
over the moun- 
tains near 
Dimrill Dale and 
Moria, diey may 
meet up with a 
Balrog on tlie 
trail (a Balrog is a 
VERY powerful 
monster, which 
is easily capable 
ofwipingoutthe 
whole party). 



As the part)^ pro- 
gresses, the dan- 
ger heightens 
from the East. In 
fact, the sheer 
numbers that die 
Adversary com- 
mands guaran- 
tee eventual vic- 
tory^ if the Ring is not destroyed in Ume. The 
various strongholds of Dwar\^es, Elves and 
Men (Minas Tirith, Lothlorien, Edoras, and 
so on) can usually hold out against one or 
two assaults, but their numbers are re- 
morselessly ground down. The average 
odds are 6 or 7 to one. Furthermore, the 
forces of evil have a number of strong 
forces the Good legions cannot match, 



including a brigade of trolls from the inte- 
rior of Mordon An ore matches up evenly 
against most Man, Dwarf, or Elf foot sol- 
diers. 

The strongest figliters available to the 
player (Aragom, Faramir, Gandalf, and so 
on) are also even matches for the Nazgul in 
single combat, but can be overrun by 
numbers (the author managed to get Ar- 
agom killed at die beginning of one game 
in such an encounter). This element of 
tension — of knowing that any of the char- 
aaers are vulnerable and subject to death 
by a player's mistake or by happenstance^ — 
adds an exciting and higlily desirable ele- 
ment of realism to the game. 

It is difficult to get the Ring to die 
Mountain. A full division of 10,000 Ores is 
stationed at each pass of the mountain 
ranges encircling Mordor. The only method 
possible to enter tiie evil regions unde- 
tected is to wait until those large forces set 
out on campaign. It is then diat time is most 
crucial, and destruction of the Ring most 
imperative. NX^en a large battle is joined, 
some very realistic and dramadc sound ef- 
fects are played and a running score dialog 
box is displayed showing lio^- the relative 
balance of power shifts during the bacde. 

Should the player lose the Ring to the 
Nazgul (usually because Frodo and his 
escorts have been killed), or to some other 
force, die evil being in possession will im- 
mediately head for the Dark Tower in 
Mordor. It is possible to intercept the Ring, 
however, by deploying some opposing 
forces to meet it. It is not necessary to have 
Frodo destroy the Ring in order to win; any 
allied character can do the job. 

Tlje Losing Player May Need Therapy 

For one who has read the books with 
as much enjoyment and intensity as I have, 
the experience of losing this game is a de- 
pressing one. It seems, however, tliat play- 
ing the game entirely in a hastier speed 
somewhat enhances the odds for the oppo- 
sition. It is more satisfj^ing to brood through 
each successive stage of a campaign at 
normal and medium (Hasty) speed, and to 
save out after each segment of playing 
time. 

Overall, the game mechanics are 
flawlessly executed, and very few bugs 
were to be found. In the first copy pur- 
chased, characters occasionally left trails of 
bad screen data as they moved; this has 
been fixed in subsequent versions. One 
major omission in die game system is that 
of die Mines of Moria sequence — one of the 
most exciting and gripping sequences in 
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the trOogy. There is no method of entry 
through HolUn Gate into tlie mines once 
you guide the part}' there. However, ac- 
cording to sources at Melbourne House, a 
discrete and separate game, called The 
Mines of Moria, is in the works. The Moria 
segment in the books encompasses a huge 
concept, and it is difficult to see how die 
segment could have been fit into the al- 
ready huge two-disk game witliout sub- 
tracting from its quality, particLilarly on a 
5 12K machine. 

A nice feature of die game, which is 
also true of other Melbourne tides, is die 
ability to mount the program on a hard 
drive. The procedure for doing so is fairly 
straightforw^ard and should apply to most 
Amiga hard-drive owners (unfortunately, 
not so to the author's). The commands for 
hard-drive installation are: 



cd dhX: 
makedir WIME 



;tog onto appropriate partition 
; create the needed directory 



Insert disk One of WIME into dfO. 

copy diO: to dhXiWlME all ;copy disk 'A* to the directory 

Insert disk Two in dfD: 

copy diO: to dhX:WTME all ;copy disk 'D* to the direaor^^ 
assign A: dhXWLME ;tell system vvliere to find A: 

assign B: dhX:WlME ;tell system where to find B: 

cd diiX:WIME ;log to game directory 

execute s/stanup/sequence ;aciivate game 

Some difficulties were encountered 
in the course of pursuing this option. The 
system tried is an AlOOO equipped with 
both an Insider 1 Megabyte board and a 
CMI processor accelerator (with 68881) 
stacked on the 68000 motherboard socket, 
with a Supra hard-drive interface and 50 
Megabyte Seagate. This is most definitely a 
hybrid machine, and may not be a fair basis 
for declaring whether \V1ME does or does 
not work on a hard drive. Any attempts to 
run the game opened properly with the 
initial company logo screen and tlien 
placed the tide graphic screen, widi the tide 
music playing (which is very good). The 
machine would then hang up and give the 
Gum message NOT ENOUGH MEMORY 
with the identification number 
82011234.48454C50. 

Perhaps the problem is (and this is 
only a theory) that, upon booting the ma- 
chine to Workbench, the system occupies 
some 100 kilobytes of Chip (Video) mem- 
ory. This irrevocable Workbench alloca- 
tion does not occur when the WIME pro- 
gram is booted from a floppy disk, and so 
the entire 5 1 2K of chip me mory is a vail able 
for the program. However, I have seen the 
game function on a hard drive on botii 



The Krueger Company 
can provide a wide 
variety of MEMORY, 
MICROPROCESSOR, 
and SUPPORT CHIPS. 

ALL KRUEGER PARTS 

carry an uncoiuiitioiiiil 30 day 
guarantee. Tli c in i iii m u in 
purchase is $50.00. 

Call Myron Licberinan a( 
(800)245-2235 or FAX 
(602)820-1707. Mention 
AMAZING COMPUTING. 

I 



mmm ANOTHER TIP 

mTmnnf from dr. chip 




8 MHZ 68010 $1.00 

16 MHZ 68020 $35.00 
OR 16MHZ 68881 

41256- 150 PLCC $1.00 

64Kx4 VIDEO ZIP $1.50 

256Kx4- 120ZIP $3.60 

2764-300 EPROM $ .75 



The Krueger Company WVmW (800)245-2235. 



Circid 116 on Reader Service card. 



Amiga 2OO0's and an Amiga 1000 at the 
Melbourne House developmem lab. This 
leads suspicion to the CMI accelerator 
present in the author's test machine. (Per- 
formance of the game on hard drive is 
spectacular.) 

Furthermore, if some .\miga owners 
encounter problems with their installation, 
a possible fix is to delete the line "run 
NoFastiMem" from the startup-sequence 
file on the game boot disk. This should fbc 
any problems. (Once again, on our test 
machine this did not work. Some guys have 
all the luck.) 

Another intelligent design feature is 
the lack of copy protection in die package. 
Archival copies are easily made. The only 
form of protection, and a higlily unobtru- 
sive one, is a dialog box that appears at 
periodic stages of the game, asking for tlie 
location of a specific town on the large map 
of Middle Earth provided with the game. 

War in Middle Earth is an excellent 
product, and the substantial amount of 
work tliat was invested in it is apparent. 
The progranimers and designers made a 
real effort to accommodate all the possible 
needs of the user. The design is clean and 



well structured, the graphics are superior to 

at least 90% of the Amiga games out there, 
and the user interface is smooth and func- 
tional. Combat sequences are somewhat 
inflexible and non-interactive: given the 
limitations of the two-disk fomiat and the 
design for tlie 51 2K machine, rhis aspect is 
understandable. Overall, WLME is well 
worth the price, and a real treat for Tolkien 
fans. It is a privilege to re\^iew a product 
that aspires to such excellence. 

•AC* 
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Roomers 



by 77je Bandito 

pTlje statements and projections 
presented in "Roomers "are rumors in 
the purest sense. The hits of 
infortnation are gathered by a third- 
party sourcefrom whispers inside the 
industry. At press time^ they remain 
unconjirmed and are printed for 
entertainment value only. Accordingly, 
the staff and associates of Amazing 
Computing™ cannot he held 
responsible for the reports nmde in 
this columtLj 



The Bandito 's got a bagful of 
interesting tidbits diis time. It must be die 
holiday season and all that peace and 
goodwill that makes the mmors fly like 
little snowflakes, witli no two exacdy alike. 
Let's take a look at what's been sticking to 
the Bandito's screen this time. 

Both Electronic Arts and Broderbund 
are expected to go public before the end of 
the year, taking advantage of the strong 
stock market. While bodi companies have 
experienced rapid growth in the past, 
things have slowed down in recent years. 
Electronic Arts hopes to expand into the 
cartridge game market, whHe Broderbund 
continues to experiment with odd 
technologies and products, such as the 
Whole Eardi CD-ROiM catalog and their U- 
Force Nintendo game controller. The best 
thing about these companies becoming 
public is that they'll be issuing quarterly 
reports to the public, so now we'll all be 
able to see how well they do each quarter. 
What ftm! The Bandito loves being a 
Monday-morning quarterback. The pay 
isn't great, but at least you don't get injured. 

Speaking of stocks, things are very 
interesting over at Atari, Atari profits took a 
nose-dive, dropping 95% in the second 
quarter. Sounds like the stock price should 
drop, right? Not exactly, Atari stock has 
increased more tlian 20%. It is now much 
higher than Commodore stock (airrently 



ho^^ering around 10) with a price/earnings 
ratio twice thatof Coramodore. Why, you 
ask? Don't these investors know anything 
about the evil Tramiels and dieir u*ack 
record? 

Apparentlyj investors are pinning 
their hopes of Atari recovery^ on three 
tilings; the PC Portfolio, a tiny PC clone die 
size of a videocassette; the Ep^rx handheld 
video game, now called the Lynx; and the 
STE, their "Amiga-killer" (where have we 
heard that term before?). The STE is like an 
Amiga witliout some of tlie Amiga's 
features like DMA, expandability, 
multitasking J or a softu^are base. Sounds 
like a killer, but the Bandito suggests they 
look to see which way the barrel of die gun 
is pointing before tliey fire it. 

Atari is also announcing several 
models of Atari TT, which makes things 
somewhat confusing. The Bandito has 
been unable to sort through the 
tremendous hash of distortion, stauc, 
misuiformation and pure wishful tliinking 
diat surrounds these puppies. So here's 
some of the best ones that the Bandito's 
heard, and you can make up your o^^n 
mind. 

Supposedly, an Atari press release 
from Dusseldorf lists these stats about the 
Atari 1040 STE: l6 (some say 512) colors at 
once out of a 4096 color palette in 640 by 
480 resolution, horizontal and vertical 
hardware controlled scrolling, genlock 
ready (whatever that means — gee, even a 
Macintosh is genlock ready if you spend 
enough money), 8 bit stereo PCM sound 
(the number of channels is unavailable), a 
new 256k TOS, and ports for a lightpen and 
up to 6 joysticks. No word on whedier it's 
compatible with previous ST soft^^are — 
probably somewhat compatible, but not 
fully, is the Bandito's guess. Sounds like as 
much of an Amiga-killer as the Apple IIGS 
has been. Of course, other sources say that 
it will be running a l6 MHz 68030. 



Some of the Bandito's otlier sources 
say die Atari TT wall list for $1,500, use a 16- 
MHz 68030, 2 megs of RAiM; a 3-1/2 inch 
floppy; genlock on the motherboard; tliree 
VME bus slots; and 13 different video 
modes, including 640 by 480, l6 color and 
l,280-by-960 monochrome. This is not the 
STE though the price sounds confusingly 
similar. The Bandito's guess is diat the STE 
will sport the $1500 price tag and the TT 
W'ill be in die S3000 bracket, if not more. At 
least, the word is that the die TT will ship 
in die UK in November widi a 60 meg HD 
for X2000, or the equivalent of about $3000 
U.S. Oh, and it will be shipped witli UNIX 
starting next year, chough how that's going 
to perfomi squeezed into a mere 60 Meg 
hard disk is a little hard to tell. 

From yet another source, die Bandito 
hears that Atari Ls introducing three 
macliines based on a 16 MHz 68030, all 
widi at least 2 megabytes of RAM. The disk 
drives are said to be compatible wid:i 
Macintosh disk drives. 

So when will we see these machines 
in the states? Probably not till sometime 
next year, given the time required for FCC 
certification. And maybe never, since it's 
unlikely the U.S. market will accept a UXEX 
workstation witli an Atari label on it. Look 
at the amazing success of die Mega ST 
series. What amazing success, you say? 
Yeah, that's the one. The Bandito predicts 
that the TT series will never get sold over 
here. The STE will do no better dian the 
Mega ST line. The only good products in 
their lineup are tlie PC Folio and die Lynx; 
tlieir success is uncertain, but at least they 
have a chance. The STacy laptop may enjoy 
some sales largely as a Macintosh 
compatible laptop by adding on a Spectre 
cartridge. All in all, the Bandito doesn't 
think that Atari is a credible direat to the 
Amiga. As Pogo might put it, Commodore's 
biggest enemy is it-self. 
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The Bandito has spent more long 
hours sifting through dumpsters in 
Westchester parking lots, which has 
gleaned some interesting facts. You know, 
it's really amazing the number of Oreo 
cookies, Fritos, and Pepsi that 
are consumed by 
those product 
development guys. 
Aside from that, the 
Bandito discovered 
many grease-stained 
documents of 

discarded A3000 
circuit layouts. 
Apparently, they're 
still busy revising the 
final product, and 
tliere's more than 
one competing 
design- Commodore 
is playing its ROM 
cards close to its 
pocket protector 
and waiting to see 
what ail the other 
guys are doing 

before committing lo the A3000 
arcliitecture. One of the big decisions is the 
price point. Commodore can make as spiffy 
a machine as could be desired, but then it 
might end up priced like a NeXT machine 
(which is Lisa spelled sideways, for those of 
you w^ho remember tlie good old days of 
Apple). So they're trying to make it 
expandable and powerful, but keep 
compatibility with the software base and 
keep the price tag down. Don't expect too 
much to be standard. The Bandito would 
be happy with a fast processor, extra 
addressing to allow more tlian 9 megabytes 
of memory, and an easy way to get 
expanded graphics modes. A way to soup 
up the blitter would be a nice touch. 

While product development's plans 
are still in flux, marketing is going full-till 
for Christmas. Commodore's marketing 
budget for Xmas is $20 million, which puts 
it in the big leagues of Christmas 
advertisers. In fact, we should see more 
Amiga ads tlian Apple ads this Christmas 
during the "Amiga 500 Holiday Campaign." 
Of tliat money, SI 5 million is going into 
print, TV and radio advertising. There's also 
a lot more money being spent on 
promotional materials, dealer training, and 
the like. The campaign is centered around 
the Amiga 500. 



Co m m odo re 's marketing 
budget for Xmas is $20 
million, which puts it in the 
big leagues of Christmas 
advertisers. In fact, we 
should see more Amiga ads 
than Apple ads this 
Christmas during the 
'Amiga 500 Holiday 
Campaign.'' 



As the Bandito has been telling you 
all along, the Amiga 500 is going to be sold 
in some mass market outlets. A500's to go 
into Sears Business Centers and the Service 
Merchandise chain this fall. Check out the 
new Sears catalog to see the Amiga 500 in 
blazing color. 
An important 
note: besides 
having lots of 
stores, Sears 
also does a huge 
volume of mail- 
order business. 
Along with 
advertising 
push, this is 
expectecd to 
generate a very 
good Christmas. 
The strategy is 
to push A2000 
and higher 
computers 
through 
retailers, using 
die A500 as the 
hook to get people interested enough to 
visit a dealer and ask questions. Hopefully, 
Commodore's dealer training efforts will 
help tiie dealer turn those inquiries into 
sales. The main purpose of die ad 
campaign is to build name recognition — 
rigiit now, most people have never even 
heard of the Amiga, so it*s awfully tough to 
sell them one. Will it work? A lot depends 
on how good Commodore is at the follow- 
up — mnrjing interest into sales. They must 
provide training for dealers on how to sell 
Amigas more effectively. A new version of 
die Test Flight video is planned, which was 
a very successful way to show off the 
power of tlie Amiga. 

While the fact that Commodore is 
spending a lot of money on commercials 
this Clirislmas sounds hopelul, war>'^ 
Amiga-watchers are cynical. Remember 
tliose early Amiga TV ads, widi the guy in 
tlie white robes walking up lo an Amiga in 
a temple, and then getting high on the EMR 
coming out of tlie screen? Yeah, the 
Bandito 's been trying to forget those, too. 
Well, these new commercials should be 
hot. Their being produced by none other 
than George Lucas and Matthew Robbins 
(director of Batteries Not Included) — an 
entire series of Amiga commercials. The 



new commercials will start on Oct l6th 
(from Lucas Film Commercials) with 
Entertainment Tonight nmning followups 
on the making of the commercial every 
night that week. Sounds like a special 
effects spectacular. And why would 
George waste his time doing an Amiga 
commercial (no matter how much they 
offered him), when he could be working 
on Star Wars 1: A New Cash Cow? The 
Bandito hears that George is a big fan of the 
Amiga and wanted to give it a helping 
hand. The Bandito hopes that it's true — 
the Amiga could use a few influential 
friends like that. 

In other good news, tlie Bandito 
found this tidbit floating in the 
stratosphere, bouncing between satellites 
on its way to being a new^s release. 
"Anticipating a strong demand for its Amiga 
and PC products following die launch of a 
new advenising and promotion campaign. 
Commodore Business Machines, Inc. 
recently announced a major re-seller 
agreement with Connecting Point of 
America, Inc. 

Under the agreement, effective 
immediately, Connecting Point of .America 
will warehouse, re-distribute and sell all 
Commodore Amiga and PC line hardware 
products. The fastest growing franchisor of 
retail computer stores in the United States, 
Connecting Point of America operates 
more than 325 outlets nationwide, 

"Connecting Point of America has an 
outstanding group of store owners. 
Commodore is pleased to associate with 
such a major player, as we embark on a 
new chapter in our company," said Hany 
Coppcrman, Commodore Business 
Machines president. 

Connecting Point CEO Mark 
Schumate confirmed the agreement, 
saying, "We're happy with the new 
direction and new management team at 
Commodore, It's important that we're 
taking this major step at lliis time, when we 
anticipate great new things for their Amiga 
and PC product lines." 

Added Connecting Point Vice 
President of Merchandise Michael H. 
Weiss, "Coniiiiodore's new advertising 
campaign was the impetus for us to begin 
our association now. We are sure bri.sk 
fouitli quarter sales of Amiga and 
Commodore's PC products will be the stan 
of a satisfying new association." 
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Zorro II 
Prototyping Board 

* Over 4400 Plated Holes on a 0. 1" Grid. 

* Gold Plated F::dge Connector. 

** "D^'-type 1/0 Connector Pattern. 

* Accepts 64 Pin DIPs and 14x14 PGAs. 

* Low Inductance Power and Ground 

Pattern for High-Speed Designs. 

* Designed for Maximum Flexibility. 

* Includes Mounting Bracket. 

To order, send: 

check or money order for S49.95 + 

local sales lax (California only) + 

shipping & handling iVS: S3. 00. Foreign; S6.50) 
in US dollars to: 

Celestial Systems 

Suite #165 

Box J 

Manhattan Beach. CA 90266 

(213) 372-1229 



Ctrcle 114 on Reader Service card. 

Real interesting, don't you think? The 
Bandito just loves reading between the 
lines. Sounds like the decision to spend so 
much money on Christmas marketing is 
already paying off. The Bandito also 
suspects diat the Man of Copper was a 
good choice for President of Commodore, 
since he seems to be the mover and shaker 
behind all of tliese positive changes. 
Things are looking up — now if only 
Commodore actually sells a lot of Amigas 
over Christmas, tlie 1990*s will look like the 
Decade of the Amiga. 

The Bandito discreedy discovered 
some discarded discs in a dubious 
dumpster following a wild weekend in 
whimsical Westchester. Using DiskDoctor 
and great care, tlie Bandito was able to 
ferret out some hints about Conrunodore's 
plans for next year. Wider mass-market 
distribution for the Amiga 500 is planned 
for 1990, if the test this Christmas proves 
successful. Plans for Toys H Us are on hold; 
Commodore may not want the A500 there 
for image reasons. As RAM prices continue 
to drop, the main bone of contention is 
whetlier to lower die retail price of the 
computer or to include 1 megabyte of RAJVI 
as the standard. Arguments mustered by 
bodi sides are heated. Hopefully, RAM 
prices will drop low enough that the 
difference becomes negligible, at which 
point 1 megabyte should become the 
standard. Look for announcement in the 
spring. 

This Cliristmas is being watched 
closely by WordPerfect, among other 
softw^are giants. Strong Amiga sales could 



revive the dormant PlanPerfect Amiga, and 
possibly even WordPerfect 5-0 for tlie 
Amiga. Other companies have held 
discussions with Connmodore about 
software development of important 
packages (liigh on the list: CAD software), 
but the consensus seems to be "we'll see 
how you do over Christmas, and then well 
talk". One of the more interesting 
questions to be answered is whether or not 
the campaign, which focuses on the A500, 
will manage to sell appreciable numbers of 
A2000's and A2500's. That^s what 
Commodore is hoping, anyway. The 
Bandito wonders if Commodore is going to 
help tlie dealers reap die benefits of these 
greater Amiga sales by encouraging the 
new Amiga owner to see a dealer for 
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pmeTami *hich tuni your AMIGA* into t muiic*! mitrumenit. i 
MIDI event procciior, tnd *ii audio special effecli 
enefitor ALL AT THE SAME TIME Ht The MUSIC 



MUSIC MODULES it m inieeTited packige of toftwire 

"^crami *hich tuni your AMIGA* " ' ' ^ " 

IDl event procciior, tni 

genefitor ALL AT THE £ 

MODULES STARTER KIT contiin* iheie 5 feiiure picked 
modules: iCEYBOARD CONTROLLER (uie AMY's keyi like 
piano keys + mouie piichbend 4 volume), MOUSE TO MIDI 
[.use AMY'i mouse lo jam m Mny one of 144 musical icmlei +- 
pitchbend + volume), SAMPLED SOUNDS PLAYER (use up to 
^0 IFF sound Tiles at once, each w/ independent volutne. 
pitchbend, A tuning), HARMONY (auiom»ncillv playj one of 29 
type* of harmony while you play the tnelody, uie multiple 
modules for automatic chords). MIDI DELAY A SHIFT (real 
lime delay adjustable from 16 mice to over ft seconds > 
pitchshift + feedback). MUSIC MODULES hai extens ive MIDI 
capabiliric* for the pro musiciin but ii caiy 
to use artd enteruming for the hobbyist. 
MUSIC MODULES is flexible and 
eipandible. Call for info on new modulex. 

CALL: (508) 688-0599 
MUSICOMP TECHNOLOGIES 
176 BR0ADWAY,3RD FLOOR 
METHUEN, MA 01844 

OVERSEAS SHiPPi«3 AOO td^« ^ UASa RESU3EKTS ADD i% TAX 
VISA AMO UASTEflCAftO ACCEPTED ~ OEALER WOUlRl£S WELCOME 
WtOA tSA REOISTEBED TTUQEMAWK OF COMMOOORE-AUKM . i.'C. 



STARTER KIT 
ONLYS49.95 



Circle 159 on Reader Service card. 

software and peripherals. After all, Sears is 
just going to carry the machine itself, and 
maybe one or tu^o pieces of software 
sometime later. The proud Amiga owner is 
going to have to find a dealer somehow. 
Dealers are hoping tliat Commodore 
provides an answer. 

The Bandito predicts a rough 
Christmas season ahead for the 
entertainment softw^are giants. From all 
reports, tliere's a distinct lack of exciting 
new products for the fall A lot of "me-too" 
products, including enough tank 
simulators to provide an entire field of 
Presidential candidates with photo 
opporainities. Tlie smaller publishers will 
generally do better, though some of them 
(without a hot product) will have a tough 



time getting shelf space this year. Who'll 
have the hottest Amiga game this 
Christmas? The Bandito suspects that 
Cinemaware might take tlie prize. 

Demo Reel II? The Bandito's 
informers report that NewTek is readying a 
sequel to their very popular demo for 
distribution this Christmas. As before, it will 
have zippy animation, great images, and 
advertise at least one product tliat isn't 
available yet. Say, what ever happened to 
Digi-F/X, an>w^ay? Maybe we'll find out in 
1990, 

Late-breaking news; Ep}^ has 
pruned itself back to a stub, and 
announced tliat it's quitting the computer 
software business. They've laved off 90% of 
their employees from tiieir high of 150 a 
yeai" ago, leaving a mere handful to 
continue ainning the skeletal remains. 
Dave Morse has resigned as chief 
executive, and Dave Needle and RJ Mical 
(the rest of the ex-Ami gans) have also gone 
looking for new work. Epyx has 
armounced that from now on they will only 
produce Nintendo and Lynx products, no 
more computer software. What happened? 
The Bandito will present the sordid stor>" 
behind the facts next time. 

Be sure to come bacl'C next time — the 
Bandito is nourishing a new crop of ai mors 
to satisfy your e\^er-growing curiositv'! 



*AC* 



Oriental Desk Top Art^-^ 

Vol. 1:0nential artwork. 

Vol. 2:Marlia! art figures. 

VoL 3:0riential folk art. ^^ ^ *^ 

Vol 4:Chinese Font. Tp n& ^ 




t 




High resolution images 
IFF format 

Use as clipart in desktop 
publishing progranns 



Price: $29.95 per VoL plus $3.0 (in US) 
for shipping. Send check to order 



Software Integration Solutions M 
1 1 027 Twin Pond Terrace ^^^^^ 
San Diego. CA 921 28 wi^; ^"^ 

Tel: 619-748-3350 
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New Products and 
ether Neat Stuff 



by Elizabeth G. Fedorzyn 



Yossarian never bad it so good 

Okay, Falcon F-I6 fans, it's time to 
don your scarf and goggles and prepare for 
new, unchartered missions. Spectrum 
Holobyte has released the Falcon Mission 
Disk, Operation: Counters trike, a pack- 
age designed to enhance tlieir very^ popular 
Falcon F-I6 Flight Simulator, expanding it 
to a full campaign. 

Operation: Counterstrike features 12 
new missions set in a new terrain with new 
strategy elements > and more viscious ene- 
mies. The missions are intended for succes- 
sive play, the overall objective being to fly 
into enemy territory' and disami the en- 
emy's offensive. The enemy force includes 
four types of moving \'ehicles — tanks, 
trains, amphibious landing craft, and 
trucks. Nasty MiG-29's have replaced the 
MiG-2rs. 

As with the original Spectn.]m Holo- 
Byte program, every enemy target de- 
stroyed contributes to a pilot's success, but 
points are awarded for destroying specific 
targets depending on what mission has 
been selected. Operation: Counterstrike 
also features the same five levels of diffi- 
culty — from 1st Lieutenant through Colo- 
nel. For those seeking a taste of glory, one 
of five medals — from the Purple Heart to 
the Medal of Honor — may be awarded to 
fmer pilots. 

For those of you super-aggressives, 
Operation: Counterstrike also features the 
original Falcon's ability to go head-to-head 
in dogfights against an opponent on an- 
otlier computer. Using either a direct con- 
nect or a 1200 baud or faster modem, 
players can link Amiga to Amiga, ST to 
Amiga, or eid:ier ST or Amiga to a Mac. 

Operation: Counterstrike requires 
512K to run basic features, and one mega- 
byte RAM for additional features. The origi- 
nal Falcon program is also required. 

Falcon Mission Disk 
Spectrum HoloByte 



2061 Challenger Drive 

Alameda, CA 94501 

(415)522-3584 

Price: $24.95 

Inquiry ^235 



Does be sing "Teddy Bear'* in this one? 

No, it's not a long-lost B movie star- 
ring the King. VIVA, which stands for 
Visual Interlaced Video Authoring, is 

tlie latest contender in the Amiga hyperme- 
dia authoring systems race. Written by Paul 



Benson for Knowledgeware and marketed 
by MichTron, VIVA is an icon-driven, inter- 
active program that allows you to create, 
manage, and display information. 

Using \WA's object-oriented inter- 
face, you can control text, graphics, video, 
sound, color, and animation. \T\^A is ca- 
pable of controlling external media devices 
including video editors, laser video disc 
players, and CD ROM drives. Its abilities 
can be exploited cowards a great number of 
ends, including general information distri- 
bution, sales, and simulation. 



Top Game: 

Spectftim 

HoloBytes* 

Falcon Mission 

Disk 



Interactive 
byperfnedia with 

pizazz: VIVA 
from MichTron 
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VIVA represents an easily compre- 
hendible system designed to appeal to 
novices as ^well as more advanced pro- 
grammers and developers. Each icon rep- 
resents a function, such as PLAY or ASK. 
These icons are then grouped according to 
function areas, such as VideOj Audio, Math, 
Text, etc. Thus, creating an application that 
incorporates a variety of media is a logical, 
if not entirely organized, undertaking. 

MichTron's VWA requires 2 meg of 
RAM. The package includes two program 
disks and a 250' -page manual. 

VIVA 

MichTron 

576 S, Telegraph 

Pontiac, MI 48053 

(3 13)5700 

Price: $99S5 

Inquiry ^236 



Miss Pineapple, et at 

Well, sure, maybe on his second or 

third shot — -but who would have thought 
tliat on his first time out Joe could produce 
such a massive collection of clip art for the 
Amiga. But that's just like Joe, now isn't it? 

Pic-Magic, from Joe's First Com- 
pany, Inc. is a new^y released lO-disk 
collection of over 250 clip-art images for 
use in presentations, newsletters, etc. The 
graphic images are designed to be im- 
ported into existing Amiga programs, such 
as DeluxePaint, w^here diey may be col- 
ored, resized, or otherwise manipulated. 

The collection covers a wide range of 
familiar and not-so familiar images. For 
instance, I don't know about you, but I 
can't count the number of times I sat 
cradling my wear)' head, musing, "Gosh, if 
only I had an image of a tap-dancing 



tomato — why, my presentation would be 
perfect ]" Well, no more sleepless niglits, 
because not only has Joe included tliis 
often sought-after image, but he has also 
made available images of Joe Average and 
Miss Pineapple, as well as some "less 
conventional" pieces, like Christmas im- 
ages and sports figures. 

Pic-Magic includes ten disks organ- 
ized according to subject (e.g.. Disk One: 
Animals, Disk Two: Sports, etc.), and a 220- 
page manual that includes representation 
of every image included. 

PiC'Magic 

Joe's First Company, Inc. 

P.O. Box 579, Station Z 

Toronto, Ontario M5N2Z6 

(416)322-6119 

Price: S 85 ^00 

Inquiry #23 7 



Better than a Craftsman Deluxe 

Progressive Peripherals has released 
Diinlap Utilities, a collection of multi- 
taskings tools that would make even Bob 
Villa envious. Written by Peter Dunlap, diis 
collection features 77 programmable func- 
tion keys and over 40 interactive programs 
operable by a single keystroke or mouse 
click, with all program modules being able 
to work together or independently. 

The Progressive Peripherals package 
offers the user a wide variety of possible 
enhancements. With DU, you may remo\* e 
read/write errors from your floppy or hard 
drives without reformatting. And consid- 
erably fewer follicles will be jolted out of 
place as the program also allows for the 
recovery of accidentally deleted or dis- 
carded files, thus greatly reducing in- 
stances of acute anxiet>^ 



Are your hard drives up to par? 
Weil, why not put them through Dunlap 
Utilities' evaluation and test uUHties? Then 
adjust for optimum performance. You can 
also monitor all system data with Dunlap 
Utilities. 

Tired of spending die better part of 
your life in front of a computer monitor? 
Heck, why not get out; take in some of that 
peak foliage. With Dunlap Utilities, you 
don't even have to be at your computer in 
order to get results. When the program 
detects inactivity, it v/ill execute any pro- 
gram or function you have set. For instance, 
during times of inactivity, Dunlap Utilities 
will blank your screen to extend monitor 
life, play background music, or verify disks. 

Bored with the same ol' screen? Well, 
witii Dunlap Utilities, you can customize 
your Workbench screen by changing fonts, 
colors, pull-down menus, or screen resolu- 
tion. You can even eliminate the CLl and 
Workbench completely. 

You can use custom-designed IFF 
pictures to perform funtions or play 
sounds. Or run your entire system from 
your "sensitized" pictures. Even build your 
own IFF'based mrnkey system. 

Or maybe you're more of a text kind 
of person. Dunlap Utilities allows you to 
replace icons with text headings. Whatever 
your preference, this Progressive Peripher- 
als package will no doubt contain the tools 
necessary^ to fine tune your ^*Vmiga. 

Dunlap Utilities 

Progressive Peripherals and Software 

464 Kalamath Street 

Denver, CO 80204-5020 

(303)825-4144 

Price: $79.95 

Inquiry #238 




Dunlap Utilities fwm Progressive Peripherals 



Central Coast Software 's MaC'2-Dos 
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Amiga Logo 

Commodore Business Machines, Inc. 

1200 Wilson Drive 

West Chester, PA 19380 

(215) 431-9100 

Inquiry *240 

FormAtion 

Iconochissic Software 

P.O. Box 31323 
Richmond, VA 23294 

(804)273-0312 
Inquiry *24l 

Gauntlet n 

Minciscape, hic. 

3444 Dundee Road 

Nortlibrook, IL60062 

(312) 480-7667 

Inquiry *242 

Icon Magjc 

Glacier Technologies 

P.O. Box 1309 

Vancouver, WA 98666 

(206)694-1539 

Inquiry *243 

International Cliampionshlp Wrestling 

Avatar Consulting 

9733 Roe Drive 
Santee, CA 92071 

(619) 449-7780 
Inquiry *244 



On-line* Platinum Edition 

Micro-Systems Software 

12798 Forest HUl, Boulevard, Suite 202 

West Palm Beach, FL 33414 

(407) 790-0772 

Inquiry #245 

Real-Time Sound Processor 

ADEPT Development 

P.O. Box 20 

1000 Uusanne 5 

Switzerland 

Inquiry *246 

Record Manager Information Base v. 1,4 

HC Software AusU^lia 

GPO Box 2204 

Adelaide South Australia 5001 

(08) 344-6897 

Inquiry *247 

Red lightning 

Strategic Simulations, Inc. 

1046 N, Rengstorff Ave, 

Mountain View, CA 94043 

(415) 964-1353 

Inquiry ^248 



Shadow of the Beast 

Psygnosis 

122 Centuo^ Buildings Tower Street 

Brunswick Business Park 

Liverpool L3 4BJ England 

(051) 709-5755 

Inquir>^ #249 

Studio Magic 

SunRize Industries 

3S01 Old CoOege Rd. 

Br>'an, TX 77801 

(409)846-1311 

Inquiry ^250 

Targhan 

Star Games 

708 W. Buffalo Ave, Suite 200 

Tampa, FL 33603 

(813) 222-0006 

Inquin^ -251 

Virus Protection Toolbox 

Abacus/5370 52nd Street SE 

Grand lipids, MI 49512 

(6l6) 698-0330 

Inquiry #252 

VTX-On Line 

MichXron 

576 S. Telegraph 

Pontiac, MI 48053 

(313) 5700 

Inquiry- -253 



Mac tendencies 

Amiga users with a penchant for 
certain Mac feaaires, stand up and be 
counted. You can now have access to Mac 
pluses without foregoing your Amigan 
loyalties and witliout fear of being osira- 
cized from your local Aniiga users group. 
Central Coast Software's Mac-2-Dos now 
provides Amiga users with tlie ablility to 
read and write all types of files to and from 
400K and 800K Macintosh floppy disks. 

Now, graphic images from Mac pro- 
grams like MacPaint or MacDraw can be 
imported easily, or Amiga PostScript docu- 
ments can be outputted to a Mac disk 
whereupon diey may they may ha\^e better 
access to high-qualir\% professional type- 
setting equipment. Amiga users can also 



have access to the substantial collection of 

Macintosh clip art available. Mac-2-Dos 
allows conversion of Mac ASCII files to and 
from the Amiga. And musicians can transfer 
Standard xMTDI Files (SMF) between the two 
machines. 

Upon transferring files, Mac- 2- Dos 
automatically transfers and converts icons 
for the files, or creates icons if need be. 
Graphic file conversion is made easy widi 
die Mac-2-Dos resolution options. 

Selecting files to be transferred is as 
easy as 1, 2, or 3. A split-screen directory 
lists all Mac and Amiga files available for 
transfer. Files to be transferred may be 
selected individually, multiple files may be 
"tagged", or entire groups of files may be 
seleaed. 



xMac-2-Dos works with any Amiga 
and requires a Macintosh external 3.5" 
drive. There are two packages available. 
Package A includes custom hardware inter- 
face, file transfer and fde conversion soft- 
ware ^ and adaptor cable. Package B fea- 
tures all the elements of Package A, as well 
as a Mac-compatible 3.5" disk drive. 

Mac-2-DQS 

Central Coast Software 

424 Vista Avenue 

Golden, CO 80401 

(303)526-1030 

Package A: $99 S5 

Package B: $34995 

Inquiry #239 

•AC* 
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by Barry Solomon 

Genlocks. Whewl There's a lot to be 
said about that little word. If you're new to 
Amiga video or tlilnking of getting into it, 
read on. The rest of the class can just skip 
ahead to the next article. 

O.K. Let's do tlie basics real quick. 
What is a genlock? A genlock is really two 
devices in one neat little package. First, a 
genlock encodes. That is, it takes the video 
signal (RGB) from your Amiga (500, 1000*, 
2000, or 2500) and changes it into rt^ 
video: NTSC, the kind your TV and VCR 
deal widi. The problem here is not only tliat 
RGB and NTSC are very different ways of 
creating a picture, but Uiey are radically 
different in basic quality, 

RGB can not only give you much 
better resolution, but it can also give you 
much more accurate and purer colors. In 
fact, in the video biz, NTSC is said to stand 
for Never The Same Color! There are a 
number of teclinical reasons why these 
differences exist, but they don't matter! 
(Have faith, I'll deal witli tliis matter later.) 

The second thing a genlock does 
(this is really the genlock part) is it allows 
you to overlay your newly encoded video 
signal over an outside video signal, such as 
a camera or VCR. Too many people get 
hung up on this aspect of most genlocks. 

A serious genlock is going to set you 
back quite a few dollars. The thing to 
remember is that, if you w^int to do Amiga 
video, everything you do depends on your 
genlock! The fact tliat you are the world's 
greatest animator or computer artist will 
not matter one iota if you can't get your 
product cleanly on tape! 

Whether or not you even need a 
genlock or a straight encoder depends on 
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» CAVEAT COMPUTASAURUS ^ 

(or, genlocks and bagels) 



what you will be doing. If you only need to 
output what you're doing to tape, then you 
really only need an encoder. (See me next 
month for more on tliis topic!) Tiie problem 
is that there really isn't much in the Amiga 
market in the way of straight encoders, I 
know of an inexpensi\'e one tliat lists for 
less than $100. It stinks. At least I think it 
does. 1 also know of a professional model 
for the Amiga which is quite excellent. So 
is its price. That one lists for around $3000! 
Like I said, whew! 

The most important rule when 
choosing a genlock is pretty much the same 
as with any purchase: know what you need 
and want. You need to be aware of the 
many levels of quality, as well as the many 
levels of features. To my mind, picture 
quality is by far the most important 
criterion. You may be able to live witliout 
some of the features (faders, reverse 
keying, etc.) but if you don't have the basic 
picture quality you need, you're dead 
before you slan. 

What kind of quality will you need? 
That depends upon your plans and 
ambitions. If you just want to tlirow titles on 
the videotape of your Uncle Joe's wedding 
or "beam" yourself up in a home movie, 
you may be able to get away with 
something very basic and, therefore, 
inexpensive. If you videotape weddings 
and Bar Mitzvahs for profit, you will need 
sometliing a little bit better. If you are going 
to be doing instructional videos or 
industrial videos (sales training, corporate 
repons, in-house promotional videos, 
etc.), you'll definitely need something a 
little bit better. If you ever plan to have your 
work appear on local cable, you will have 



to get seriou.s about a genlock. Finally, if 
you want to end up on broadcast T\^, well 
then you're competing with tlie Big Boys, 
and your output had better be perfect! 

Perfect? Yes, practically speaking, it 
is possible. If you pay enough money, you 
can get NTSC video tliac Ls practically 
indistinguishable from RGB. You are the 
only person who can determine what level 
of quality you need; don't let anyone tell 
you it isn't available. 

My first purchase ^'as tlie $80 
encoder. I was horrified. There was no way 
I could do professional video with this 
piece. I had only tried it because^ after a lot 
of diought, I decided that I didn't really 
need to superimpose my signal o\^er 
anytliing else. Since I was planning on 
working with a local video production 
company, I just needed to change my 
Amiga output to NTSC (they do all the 
mixing and overlaying for me). T thought 
(hoped) tliat maybe all of that extra money 
for the otlier models just reflected more 
features. Boy, was I xvTong, I spent about an 
hour on the phone long-distance to the 
manufacturer who kept telling me over and 
over that the output was great and that the 
only problem was that 1 was used to RGB, 
so it looked poor. Instead of just admitting 
that the quality of the unit was only worth 
die $80 1 had paid for it, he was telling me 
tliat I was mistaken. Well, I may not be an 
artiste, but I know when reds are purple 
and yellows are green, when colors bleed 
all over the screen, and when the whole 
*®%$ picture is so fuzzy it seems as tliough 
I'm looking through cheeseclotli! 

The next purchase was a popular 
model in the S400 range. It was 
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considerably better, but not $320 worth. All 
of the same problems, just less so. 

Then, on a recommendation, I made 
tlie worst buying decision I ever made. I 
spent $1000 on something which was 
advertised as a "professional" genlock. (I 
have since noticed that just about 
everything over $150 is touted as having 
"broadcast-quality output". CAVEAT 
VIDEOSAURUS!) This one was much better 
so I was hoping I could manage witli it, but 
it still had a lot of problems. Well, over a 
tliree-month period I ran up my long- 
distance bill calling the manufacturer in 
Florida only to be given excuses and 
"suggestions'* that didn't really help all that 
much. In fact, most of the suggestions 
involved "tweaking" that would have taken 
thousands of dollars worth of sophisticated 
test equipment and a trained video 
technician! Finally, I was so frustrated that 
I called one last time with the intent of 
cramming that genlock tlirough the phone 
and... well, you get the idea. You can 
imagine my astonishment when all I got 
was a recording informing me, "The 
number you have dialed has been 
disconnected. There is no new number..." 
That's right. They had gone out of business 
on me! I guess I wasn't the only one who 
had trouble witli that genlock. 

For those of you whose eyes are not 
flooded with tears at my tale of woe you 
may be interested to know that many of die 
people who designed and built this 
genlock have turned up in the same area 
of the same soudieastern state making a 
similar genlock under a similar name. I 
have used this new genlock in a 
professional editing studio. The owner of 
the studio had seen it at a trade show and 
had bought it immediately. Wlien I came in, 
he hadn't even had a chance to use it yet, 
so he hooked it right up and prepared to 
impress me! The quality was exactly the 
same as my unit (Not great for a $1000 
piece), it strangely had all the same 
problems as mine and even worse, it 
crashed the Amiga five times in a sixty- 
minute period. 

I'm not altogether sure what the 
moral of this story is (although I do know 
that genlock shopping while armed is 
illegal in most states) but I can make a few 
suggestions: 

1 . First and foremost, as I mentioned 
before, know what you need and want — 
both in features and quality. 

2. Check out the company that 
manufactures it. How long have diey been 
in business? How long are they likely to be 
in business? 



3 . Will your dealer sendee it? (CAN he 
senace it' Does he know^ anytliing about 
real video?) 

4. Please forgive me, all you nice 
mail-order companies out there, but I 
cannot recommend buying a genlock by 
mail order. My best recommendation is to 
go to your favorite local dealer and ask him 
to hook one up. Right out of the box. In 
fairness to him, please don't do this unless 
you are serious about getting the genlock, 
but don't buy one without seeing its output 
either. If there is any choice in the matter, 
view the output on a real T\^ or video 
monitor as opposed to a switchable RGB/ 
NTSC monitor like die 1084. (I always 
recommend that you use the best possible 
equipment to evaluate your work. I am not 
one of those who subscribe to tlie lowest 
possible denominator theor>^) 

If at all possible tape the output on a 
portable VCR or camcorder and tlien view 
the result on a regular TV or monitor. If you 
find one that gives you the quality you 
need, buy it. That one! Not a new 
unopened one, but the one you saw 
demonstrated. It is acknowledged among 
video pros that tlie quality control in Amiga 
genlocks is whimsical at best, so always 
buy the one you tried. 

5. I'd like to recommend that you 
don't buy more features than you need but 
diis will be extremely difficult as the 
number of Amiga genlocks is still relatively 
small. Particularly for chose of you who 
really only need an encoder. If you want 
any real level of quality you'll probably 
have to by a genlock (unless you have 
$3000). 

6. If you have the money (or access 
to it) to get serious quality, you'll probably 
find, as I did, that die very best genlocks on 
the market are not manufactured by Amiga 
people, but ratiier by video people. I'm 
very sorr^^ to have to say this and I do 
expect that this state of affairs will change, 
but if you need top qualit}^ and these 
genlocks are in your price range, do not fail 
to check tliem out. For many of you tliis will 
mean a long drive, as not many Amiga 
dealers stock the really big stuff But if 
quality is your goal, it'll be worth it. 

*7. For those of you with Amiga 
lOOO's, thank you for your patience! As you 
undoubtedly already know, tlie 1000 does 
have a composite video output. However, 
without a genlock there is still no overlay 
capability and the video output qualit>^ 
level is somewhat similar to most of tlie 
lower priced genlocks. So, if you want 
good quality, all that I have said above 
applies to you too. 



One final word on "broadcast 
quality". The parameters defined by NTSC 
video are really more an explanation of 
how the signal is to be encoded and 
decoded. The quality of the signal 
necessary to be defined as NTSC is really 
very broad. It is also really vQfv old. 
(Remember we've had NTSC video in diis 
country for over forty years,) Most of what 
you see on T\^ today is far better than tlie 
very loose NTSC standard. The FCC, video 
manufacturers, networks, and particulady 
the cable companies have been talking for 
several years about upgrading the quality 
level of American broadcast (and cable) 
television. Hopefully, one day they will 
stop talking about it and do something 
about new standards. 

Test instruments are nice to use if you 
have access to them and the knowledge to 
use tliem but, most often, our eyes will 
have to be die best judge. Use diem along 
with your brain. (One included free with 
each head!) Are die colors right? Check die 
hue (shade of color). Are the yellows 
green? Are the blues purple? Are die colors 
oversaturated? Most genlock 
manufacturers will tell you never to use a 
color over Level 1 2, particularly red, as this 
is difficult to reproduce in NTSC. This may 
work out fine for you and, depending upon 
your budget, it may be necessary. Just be 
aware that, with the really professional 
genlocks (i.e., die ones manufactured by 
tlie video companies), this is rarely a major 
problem. 

One last point to keep in mind, 
especially when looking for a genlock, 
when you really only need an encoder — 
many Amiga genlocks on the market need 
an external sync source. Remember, a 
genlock will oveday encoded graphics 
over an outside video source. To do this it 
must synchronize (sync) encoded graphics 
to die incoming video. In some cases only 
the sync from the incoming video is used. 
For some reason, many manufacturers 
expect that all that will be done witii a 
genlock is graphics overlays, so some 
genlocks do not provide a sync signal. This 
means that, even producing a small tape for 
the family (back in Palm Springs) may 
require a second VCR, or camera or 
blackburst generator (a professional sync 
generator) to provide die sync. Also 
remember that even the cheapest video 
camera or camcorder will provide a better 
source of sync than a VCR. Tape playback 
is just not considered a stable source of 
sync. Before buying, ask the dealer if the 
unit has an internal sync source. If it 
doesn't, be prepared to make financial 
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Brlw^ tbe ancient art of tbe TagOT to your amlga 




Tbc TagOT maSTE? from Empire grapbics is tbe 
first fully animated fortune telling softuiare package 
for tbe amiga. Tbe Ta?OT TOaSTE? not only 
entertains you and your friends witb its autbentic 
Tarot readings^ but it will also guide you in tbe 
interpretation of tbe mystic Tarot. 

»Two full disks of graphics and animations 
** f utty animated ^ajor 2\rcana 
* Classic 3^10 card spread personal readings 
**"Ceacbes definitiorylntcrpretation of alt cards 
» Instructs users in proper laying of cards 

£x]per*i»nc# your* futuir^e todaiy, 
ftsk you3c^ x*e t .(% i 1 e ir> for* 

Tbe TagOT TljjaSTEB 

oif* Mail clieck ox* Money ov^aejn for* S29.95 to 
EMPIRE GRAPHICS 
P.O. Box 964 
Union, MJ 07083 

Sen<l $2.00 foy deMO di ^lc ^nd cotipon 

Rmiga is a rg9isT'<»red Trad(?rrijrk of Commodor«>-Rniigii, Inc. 
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adjustments for the addition of a camera. 
[Note: After this article was written, I had a 
chance to speak with Oran J. Sands V3,0, 
one of AC'S non-resident video wizards, 
about tlie subject of genlocks. It seems Uiac 
most of tliem do use an internal sync and, 
therefore, they should be usable as straight 
encoders (that is, without any outside sync 
necessaryOh However, please be careful 
about this point. As I informed, Oran I have 
personally tried at least three different 
genlocks that (Oran says) were designed 
to, and therefore should have, worked fine 
without an outside sync source. None of 
them did work, though, witlioui it! I have 
also heard this complaint from several 
other sources- Periiaps it's ±at whimsical 
quality control of which I spoke? In any 
case, the bottom line is make sure that the 
particular unit you buy does what you 
want, when and how you want it to and that 
it does it at the level of quaiit^^ you expect. 

I received a couple of very interesting 
letters this montli. One was from a Jeff 
Pearson who wrote in regards to a project 
he is working on: 

"„.It [the project] involves digitizing 
a live background and then animating a 
group onto that background lip-syncing a 
song on tape. I have a toehold 
understanding on using a SMPTE time code 



Reader Service card. 

to tape the group on cassette, but syncing 
the animation to this cassette is beyond me. 
Can you help?" 

Well... maybe, Jeff. SMPTE time code 
(SMPTE stands for the Society of Motion 
Picture and Television Engineers) is 
something which can be very helpful in 
video work. A timed signal is inserted onto 
audio and/or videotape so that precision 
editing may be done. Essentially, each 
fractional segment of tape (audio or video) 
is marked with a number for reference. This 
identifies any given event on tlie tape so 
that you know where to cut, insea or sync 
scenes and/or sounds. 

SMPTE time-code generators are 
available for use with the Amiga and. while 
I certainly do not recommend against them, 
they are fairly expensive and are basically 
for serious professional use only. If you do 
not have a video and audio-editing system 
sophisticated enough to take advantage of 
SMPTE, it will do you no good. 

This is difficult to do without 
knowing more details about your project, 
but let me share a couple of thoughts. 

You mentioned digitizing a live 
background. It would be much easier to 
genlock your animation over the live 
background tlian to digitize it (the 
backgroundl. Would this suit your project^ 



As far as syncing your animation to a song, 
that's tough. In fact, I would officially like 
to invite any of my readers to submit any 
and all suggestions diey have on syncing 
sound and animations. If you are using 
MlDI'generated music, things are a little 
easier as it is created (or supplied) by the 
computer and can be very closely 
conu-olled by your Amiga witli the help of 
the several different programs on the 
market. If you're talking about syncing an 
animation to a record or tape, it gets a lot 
harder. 

Here's what I do. I don't! Aaually, 
what I do is to try to avoid direct syncing 
wherever possible. If you are animating, 
say, carolers singing a Christmas song, try 
to show them from the back when tliey are 
actually singing. Use a shot from beliind 
showing the house towards 'which they are 
singing. Show the delighted faces in the 
window. If you do this, there is less actual 
movement to draw, and you are only trying 
to sync general movement (swaying back 
and forth, etc.) instead of specific, detailed 
movement (actual lips moving in time to 
the music). When you create your frames 
(in whichever paint or animation program 
you use), try loading them into a program 
such as Pageflipper Plus FX where you 
have very close control of speed. Plan your 
synced sequences to be as short as possible 
to give tlie effect you want. Then use an 
audio source (CD or cassette player) with a 
speed control. There are dozens of these on 
the market and they usually will give you a 
range of plus or minus 3%, which is a huge 
difference in music speed. If you keep your 
acaial synchronized sequences short — say, 
five to ten seconds — you can usually get it 
close enough to look right. It may take 
some practice tries, and maybe a friend to 
run the VCR or the cassette deck, but you 
can usually come close enough. I hf>]>e this 
is of some help to you Jeffi 

Again, there are probably many otlier 
ways to accomplish roughly die same 
tiling, and I want to be able to share tiie best 
ones, so please write to me with your ideas. 

Well that's about all for this month. 
Please write me in care of Amazing 
Computing if you have any video questions 
or problems that need common sense 
answers. Now that you are al! experts on 
genlocks and armed with the wisdom of 
Solomon... go out and buy your 
genlocks... and have a bagel! .AC* 

Bany Solomon, Video Editor 
c/o A mazing Computing 
P,0,Box869 

Fall River, MA 02720 
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Bug Bytes 

The Bugs and Upgrades Column 



by John Steiner 

This column marks the second anni- 
versary of "Bug B>tes". I would like to take 
this opportunity to thank everyone who 
has taken the time to write and inform 
Amazing Computing readers about soft- 
ware upgrades and new releases, as well as 
software problems and work-a rounds. You 
have made my job much easier. 



ULTRACARD is a program that is 
similar co tlie popular Macintosh program, 
HyperCard, Early versions have a few seri- 
ous bugs in them and, as of this writings tlie 
current version is 1.11. If you are having 
problems with an eadier version and 
would like an upgrade, send your original 
disk and a self-addressed stamped enve- 
lope to tliem. They will provide the latest 
version to you at no charge. 



Music-X from Microillusions has 
been updated to fix a problem with the 
original version diat ties up tlie serial port, 
and fails to release the port when the 
program exits. The update is only available 
directly from Microillusions. 



The Director is a powerful graphics 
display language tliat allows tlie display of 
images, animations, and sound files. Color 
cycling of an IFF image is supported, but a 
reader has reported an incompatibility with 
the Director and color-cycled Deluxe? aint 
III pictures. Since DeluxePaint 11! has more 
cycle choices than the Director was de- 
signed to support, it appears that color 
cycling in a DPaint III image is not possible. 
The problem can be solved by using cycle 
choice numbers 3, 4, 5 and 6, and by 



avoiding numbers 1 and 2. The Director's 
CYCLE command should then cause these 
four selections to cycle properly. 



The story of problems with overscan 
mode and die 2090 hard-disk controller 
card continues. I received a letter from Dr. 
Lawrence F. Keller of Cleveland, Ohio, 
who comments about problems with Gold 
Disk's Professional Page desktop publish- 
ing soft^^are. Dr. Keller has a NEC Multi- 
Sync monitor, with an AGA2000 graphics 
adapter from Microway (±e flickerFLxer) 
installed in an Amiga 2500. The Microway 
board comes with MoreRows, a software 
utility that extends the screen display to 
over 700 x 440 pixels. He reports that 
Professional Page can take almost a minute 
to fill a file requester when using the 
overscanned screen, yet if the screen is 
placed in tlie background, the file requester 
fills almost immediately. A similar length of 
time is taken to load tlie program with the 
hard drive being accessed continuously for 
almost two minutes. He reports that Profes- 
sional Draw does not suffer from diis 
problem. A representative from Gold Disk 
stated he diought Commodore was prepar- 
ing a soft^^are fix, but Commodore ^Amiga 
Teclinicai Support denies this. 

I visited witli Gold Disk technical 
support regarding this problem, and diey 
do not recommend mnning MoreRows 
with Professional Page, especially if you 
are using tiie 2090 or 2090 A controller card. 
One 2500 owner I know of has replaced his 
2090A with a Hard Frame controller card. 
He reports no problems running More- 
Rows and Professional Page widi ±at com- 
bination. Anotlier program diat doesn't like 
MoreRows is DeluxePaint III. The K\'o get 
along just fme unless you select DPaint*s 
overscan mode. At that point, DeluxePaint 
gets very confLised, and fails to operate 
properly. 



A letter from Everett M. Greene of 
Ridgecrest, CA identifies a problem with 
the Manx C version 3 -6a assembler. If one 
assembles the code fragment: 



move.B 

dbra 

end 



(A0)+,CA1)+ 
D7,*-2 



The code appears to be generated correcdy 
but when one tries to link it, the linker dies 
and locks up the machine, requiring a 
reboot to recover. The problem is caused 
by the address counter reference in the 
DBRA instruction, according to Mr. 
Greene. If one replaces the ***-2" with a 
label reference, the problem goes away. It 
seems diat die assembler is apparendy 
generating something it shouldn't and die 
linker is not properly handling the (suppos- 
edly) bad input. 

Discussions between Mr. Greene, 
and Jeff Davis of Manx technical support 
have not produced a solution. Be cautious 
of this problem, so as not ro lose a large 
amount of source code when die system 
crashes. Mr. Greene also noted that after 
die addition of a 68020/68881 board into 
his AlOOO, several game programs no 
longer run. I have had plenty of similar 
reports of game softv^^are not operating 
propedy widi a 68020 board installed. It 
would seem that those who are contem- 
plating die purchase of a 68020 board can 
expect the possibility of their favorite game 
no longer funcuoning. Game developers 
need to write a code that won't break with 
die addition of the 68020. Widi the prolif- 
eration of add-on coprocessor boards, and 
more sophisticated applications, diis prob- 
lem may get worse before it gets any better. 
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DPAINTIII ^ 

( PLUS MOVIESETTER USERS ) 

ANIMATED FONTS 

Bring your screens to life with 
3D FONT-A full rotation 3D font 

For effects that will knock their socks off II 

pi.qciQLVE FQNT-Yes it does I 

Dlssbfve on or off screen - Rotate, Shrink, etc. 

POUR FQNT- Pour in place WOW 

Animated paint can pours the font on screen I 

pQMIC FQNT -See to believe I 

Animated cnaracters that bring your title to life 
nVFR 270 ANIMATPn BRUSHES 
Thousands of screens that bring out your best 
ONLY $ 39.95 Deilvered to VQUf JJaod 

HhAnk or M.Q. to : M^W^^^^^ 

Two Disk P.O. Box 801 

—SET" PROSSER,WA 99350 

~" WA RES ADD $3.12 TX 

CDMiNGJC^N-PREHISTORIC AND Sa - Fl 
products named are trademarks of ttiere respective oo. 
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I received an EMail letter from Peter 
Smithem \ia CompuServe regarding a 
possible problem witli Aegis Draw 2000,. 
and a work-around. Mr. Smithem reports 
that any attempt to use "SAVE AS IFF FILE" 
when in Workbench resolution will imme- 
diately cause a Guru. The menu option 
works correcdy when using medium and 
high resolution modes. Though he hasn't 
spent any time trying to track down the 
source of the problem, he has found diat 
the CMD screen dump utilit\^ from Amiga- 
DOS can capture the picture and put it on 
disk if necessary. 



A newsletter from Emerald Intelli- 
gence of Arm Arbor, MI has announced the 
release of Magellan version 1.1. If you are 
a registered user, you should have already 
received your copy. Improvements to this 
artificial intelligence software include a 
nicer user interface, and the addition of 
more sophisticated operators. An interface 
tool kit add-on module allows interaction 
with SuperBase databases, Lotus 1-2-3 for- 
mat spreadsheets, and an ARexx port. If 



you have not yet received your update, and 
are a registered user, contact Emerald Intel- 
ligence. 



Mindware International has released 
Pageflipper Plus F/X version 2,0. The pro- 
gram sports a PageSync module for syn- 
chronizing animations to external MIDI 
music, ARexx support, ANIM file compati- 
bility and over 1 00 new special effects have 
been included in the upgrade. The retail 
price of the new program is $299.00, and 
registered o^Tiers of earlier versions of 
Pageflipper Plus F/X can be upgraded to 
ilie latest version by sending a check for 
$139.00 to Mindware International. 



New Horizons Software has an- 
nounced the availability of Pro Write ver- 
sion 2.5. The additions to the current ver- 
sion include simultaneous text and graphic 
printing, user-definable page sizes, faster 



spell checking, automatic date function, 

and a coupon for a free upgrade to die next 
version of Pro Write. The cost of the up- 
grade is $20.00 plus $5.00 shipping and 
handling. To receive your upgrade, send 
the original disk and upgrade fees to New 
Horizon Software, Inc. 



Express-Way Software, Inc, is now 
shipping version 1,10 of ExpressCopy. 
Improvements include a more intelligent 
algorithm that fills backup disks an average 
of 99% full. The backup utilit)^ writes stan- 
dard AniigaDOS file format disks, for ease 
of recover^' when a hard-disk crash occurs. 
The program also makes sure that Icon files 
are copied to the same disk as the associ- 
ated directory or file. Several other im- 
provements have also been added, and the 
new version also fixes a few bugs. Regis- 
tered owners of ExpressCopy can obtain 
the update by sending $5-00 to Expressway 
Software, Inc. 



Microsmiths has released version 2.2 
of TxEd Plus. Registered owners should 
have already received upgrade informa- 
tion. Registered users who haven't re- 
ceived an update notice should contact 
Microsmiths directly to report your prob- 
lem or leave diem your new address. 



Jack Radigan, developer of JRComm, 
a fully featured terminal program now 
available as shareware, has posted a warn- 
ing to electronic bulletin boards tliat an 
illegal, early beta version of JRComm has 
been posted to the electronic netvv^orks. 
The version is really .99b, and has several 
particularly nast^' bugs in tliem. There are 
two forms of the illicit file floating around, 
but both of them have a file size of 170,300 
bytes. If you have downloaded this file, you 
should destroy it. If you are a BBS operator, 
and someone has posted it to your board, 
you should remove it immediately. 
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Commodore Amiga Technical Sup- 
port personnel have posted the latest ver- 
sion of Workbench 1 .3 to se\^eral national 
information ser\'ices, including BLx, Com- 
puServe, and People Link. The newesL 
version, 1.3.2, contains a compressed se- 
ries of files containing modified versions 
of Setpatch, LoadWB, Eval, DiskDoctor, 
SetClock, Mount, Format, DiskCopy, 
FastMemFirst, NoFastMem, SetMap, Pipe- 
Handler, Speak-Handler, FastFileSystem, 
Aux-Handler, ClockPtr, CiMD, 
info.library, version. library, serial, device, 
and printer. device. The new versions fix 
problems — some minor, some not-so-mi- 
nor, with the previous versions of the 
Workbench release. 

That's all for this month. If you have 
any work-arounds or bugs to report, or if 
you know of any upgrades to commercial 
sofD^^are, you may notify me by writing 
lo: John Steiner, c/o Amazing Computing, 
Box 869, Fall River, MA 02722 

-or leave EMail to Publisher on People 
Link or 73075, 1 735 on CompuServe. 

•AC- 



System shown 

includes a 

FastTape backup 

streamer 

plus a 

FastTrak hard drive. 
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FastTape available 

in capacities of 

60 and 150 Meg. 

Standard FastTrak 

capacities include 

20/40/80/150 Meg. 



FrntfrnM^ Hard Drive Systems 

for the Amiga® 500/1000/2000 

^ Call Xetec or your dealer for pricing and delivery. 



Amiga Is a registered trademark of Comnuxlore Business Machines, Inc. 



circle 123 on Reader Service card. 



Aegis Development Inc. 

Aegis Draw 2000 

2U5 Pico Blvd. 

Santa Monica. CA 90405 

(213)392-9972 

Inquiry #202 

Intuitive Tectinologies 

ULTRACARD 

2700 Garden Rd, .Suite 6 

Monterey CA 93940 

(408)646-9260 

Inquiry #207 

Microsmittis. Inc, 

TxEd Plus 2.2 

P.O.Box 561 

Cambridge. MA 02140 

(617)354-1224 

Inquiry #208 



Companies Mentioned in Bug Bytes 



Commodore Business Machines 

Workbench 1.3 

1200 Wilson Drive 

West Chester. PA 19380 

(215)431-9100 

Inquiry #206 

Manx Software Systems 

Manx C v3.6a assembler 

P.O.Box 55 

Shrevi/sbur/. NJ 07702 

(800)221-0440 

Inquiry #2 11 

Mindware International 

Pageflipper Plus F/X v2.5 

1 10 DunlopW. Box 22158 

Barrie Ont. CANADA L4M 5R3 

(705) 737-5998 

Inquiry #2 12 



Emerald Intelligence 

Magellan LI 

3915-AI Research Park Dirve 

Ann Arbor. Ml 48104 

(313)663-6722 

Inquiry #210 

Express-Way Softv\/are 

ExpressCopy 1. 10 

P.O. 30x10290 

Columbia. MO 65205-4005 

(314)474-9284 

Inquiry #203 

MIcroilluslons 

Music 'X 

1 7408 Chatsworth Strret 

Granada Hills. CA 91344 

(818)360-3715 

Inquiry #204 



New Horizons Software. Inc 

ProWritev2.5 

P.O.Box 43 167 

Austin. JX 78745 

(512)328-6650 

Inquiry #205 



The Right Answers Group 

The Director 

P.O. Box 3699 

Torrance, CA 90510 

(213)325-1311 

Inquiry #209 
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64 COLORS 



hy Bryan Catley 



in AmigaBASIC 



One of the first "goodies" Commodore added to tlie Amiga 
was the extra- half-brite mode. This mode effectively extended the 
maximum number of colors xviiich could be displayed on a screen 
from 32 to 64 (excluding HAM, of course). Essentially, the second 
set of 32 colors are half the brightness of tlie first 32, What this boils 
down to is that you still have ihe basic 32 colors, but you now have 
two shades of each color to choose from. 

This mode is available on ALL Amiga 500's and 2OO0's, and 
on all Amiga lOOO's EXCEPT tlie ver^^ early ones. So why does its 
use seem so rare, especially in AmigaBASIC? Well, it requires a 
screen witli six bit planes, and AmigaBASIC simply does not allow 
a screen to be defined with more tlian five (the depth parameter). 



Using extra-balf- 
brigbt mode in 

AmigaBASIC to 

get 64 colors at 

once. 




So, we are now going to show you how to add a sixth bit 
plane (via a small subprogram) to an already opened screen and 
window witli five bit planes, thereby allowing you to use colors 
through 63. Subsequently, additional half-brite windows (associ- 
ated with tlie same screen) may be opened and closed at will with 
no additional processing! 

BitPianes??? 

Before we get into how to create our half-brite screen, it 
would be as well to review what bit planes are and how tlie Amiga 
uses them to determine the color each pixel on the screen will be 
displayed in. 

A bit plane is an area of memory (associated with a specific 
screen) where each bit represents one pixel on the screen. If a 



screen has only one bit plane, tlien it can display no more tlian v^o 
colors since each bit can only be zero or one. Now^, if we add a 
second bit plane, each pixel is now represented by t^'O l:>its, and 
we have four combinations of zeros and ones for a maximum of 
four colors on tliat screen. The addition of a third bit plane allows 
up to eight colors; a fourth provides for i6 colors; while (Ivq bit 
planes are capable of showing up to 32 indi\^idual colors at the same 
time. 

The addition of a sLxdi bit plane should allow up to 64 indi- 
vidual colors, so why are the second 32 just "half-brites" of the first 
32? Well, tiie Amiga only has 32 color registers and it is these reg- 
isters which actually determine tlie displayed colors. So, \n half- 
brite mode, bit planes zero to five 
determine tlie color register (0 - 
31), and if the con*esponding bit 
in the sLxtli bit plane is on, then 
tlie brightness of the color is auto- 
matically halved. And this DOES 
provide you ^ith 64 different 
colors to work with! 

Tfje "MakeiaiB' Subprogram 

Type in listing One (the 
"MakeltHB" subprogram) and 
save it in ASCII format. Use an im- 
mediate command of the form: 
SAVE ^VIakeItHB'\A; (you may 
not use tlie menu items to do 
this). Once saved in ASCII format, 
it may be MERGEd with any pro- 
gram which desires to make use 
of it. 

When this subprogram re- 
ceives control, it makes a couple 
of assumptions. It assumes a 
screen with a width of 320 and a 
depth of twfz has already been opened, and it assumes that a 
window associated with tlie screen has also been opened, and that 
this uandow is the current window. 

The first tiling the subprogram does is to insure the opened 
screen/window is capable of displaying 32 colors; if it cannot, the 
request is ignored, (The error will be picked up on first request for 
a color above 31). Assuming all is well, tlie subprogram uses a series 
of PEEKS and POKEs, and tlie "AllocMem" and ''RemakeDisplay" 
operating system routines to create the sixth bit plane and to add 
it to the current screen. 

Control is then returned to the calling program which may 
make use of colors zero to 63 and/or open additional windows as 
desired. 

f continued on page 74) 
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where Can You Find. . . 

^^^■)^::\ 

The Fred Fish Collection / W ""^ M^ 

completely indexed, fW^ ^ ^^E.\ 

Over 2200 Amiga products 
with full descriptions and 
completely cross-referenced 

With special articles for the 
Amiga and much more? 



ACf' GUIDE Amiga 





Fall '89 

On Sale NOW!!! 

at your local 

Amazing Dealer 
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A Demonstration Program 

Listing Two shows a simple demonstration program which 
uses the "MakeltHB" subprogram to display all 64 colors on tlie 
screen, and to open a smaller, additional, window in which colors 
above 31 may also be used. 

Type it in, and then issue the immediate command MERGE 
"MakeltHB'*. If you receive an error message, you probably forgot 
to use the ",A" option. No problem! Just save the current program; 
reload "MakeltHB"; resave it with die \A" option; reload the 
demonstration program; and repeat the MERGES Now save the 
combined programs under any desired name; (except 
"MakeltHB"). 

You may now RUN the program. Assuming no typos, you will 
be presented with a screen containing all 64 colors in four rows of 
16 vertical rectangles. They are displayed in the sequence of 0, 32, 
1, 33, 2, 54, 3, 35. ...., 28, 60, 29. 6l. 30. 62, 31, 63- This sequence 
allows you to compare die standard color and its "half-brite" 
associate side-by-side. You may care to modify the loop which 
creates the colored rectangles to display them in sequence. 

A click of the mouse will cause a small secondary- window to 
be opened, also in 64 color mode. Another click will terminate the 
program. 

The three essential instmctions are SCREEN, WINDOW, and 
MakeltHB; in that order, MakeltHB need only be invoked once per 
screen, but a window must also have been opened. Failure to 
follow this sequence can produce some interesting results!!! 

Note die LIBRARY and DECLARE statements at the very 
beginning of the program. They are required by "MakeltHB" but 
must reside in the using program. (Actually, tlie LIBRARY 
statements may be placed in tlie subprogram if desired, but 1 don't 
like doing this because it results in a pause in the program's 
execution when the subprogram is invoked, while the library 
routines are loaded into memory — best to do it during program 
initialization). 

While on the subject of LIBRARY statements, this program 
expects the "exec.bmap" and " intuition, bmap" files to be in either 
the current directory, or the LIBS directory of your Workbench disk. 
If they are anywhere else, you will have to insert a CHDIR statement 
prior to die LIBRARY statements. The 'Intuition. bmap" file may be 
found in die "BasicDemos" drawer of your "Extras" disk. However, 
if you do not have an "exec.bmap" file you will either have to obtain 
one via a Public Domain source, or create your own by using the 
"ConvertFD" program which may also be found on the "Extras" 
disk. 

AmigaBASIC Half-brite Notes 

-Once you have established your haif-brite screen, you may 
use all 63 colors in die COLOR statement. Thus, COLOR 58,62 is a 
perfecdy valid statement. 

-All 64 colors may also be specified in LINE and CIRCLE 
statements. 

-All 64 colors may also be specified in PAINT statements, but 
when colors above 31 are specified, the results may differ from what 
you expect! Enough said. Experiment. 

-All 64 colors may NOT be specified in PALETTE statements; 
you are still restricted to - 31. However, since palettes 32 - 63 
always depend directly on palettes 0-31. this is no great problem. 
If you want to modify a color which is above 31, simply control it 
via the modification of its lower numbered partner. 



-Remember, using half-brite colors will require a significant 
amount of additional memory. 

-Now you can make your AmigaBASIC programs really 
colorful! 



IsnS 



SiLbprogram ro maJte current screen a half-brite screen 
thereby allowing up to 64 colors to be displayed. 
N,B. Screen MUST be defined with a width of 320, and 
first window must have been opened. 

Bryan D. Catley, March 198 9 

SUB MakeltHB STATIC 
IF WINDOW (6) =31 THEN 

bitmap. ptr&=PEEKL (WINDOW (7 ) +46) +184 

bitplan€&=PEEKW(bitmap.ptr£)*PEEKW (bitmap. ptrS+2) 

newplane.ptri'^AllocMemS (bitplanefi, 65538&} 

POKEL bitmap. ptr&+28,newplane.ptr& 

POKE bitmap. ptrfi+5f 6 

viewmode.ptr&-PEEKL(WINDOW{7)-s-4 6)+76 

POKEW viewinode.ptr&, 2'^7 

CALL RemakeDisplay 
END IF 
END SUB 



jsting Two 



Demonstration Program of the use of 64 Colors 
from AmigaBasic 

Bryan D. Catley, March 1389 

LIBRARY ''exec, library" 

LIBRARY "intuit ion. library" 

DECLARE FUNCTION AllocMem& LIBRARY 

SCREEN 2,320,200,5,1 ' Define standard 32 color screen 



' Open full sized window 

' Make screen a half-brite one 

' Note use of color 37 

64 colors with AmigaBASIC:" 



WINDOW 3, , ,16,2 
MakeltHB 
COLOR 37,2:CLS 
LOCATE 1,1: PRINT' 
pal"0 

* The following loops display all 64 colors in the 

* sequence 0, 32, 1, 33, 2, 34, etc 
FOR n=0 TO 3 

FOR m=0 TO 15 STEP 2 

LINE (4+m*19, 9Tn^44)-STEP (19, 41) ,pal,bf 
LINE(4+m*l9 + 19, 9-fn*44) -STEP US/ 41) ,pal+32,bf 
pal=pal+l 
NEXT 
NEXT 

The following loops display ail 64 colors in the 
sequence 0, 1, 2, 3, 4, 5, 6, etc 
FOR n=0 TO 3 
FOR m=0 TO 15 

LINE (4+m*l9, 9+n*44) -STEP (19, 41) ,pal,bf 
pal=pal+l 
NEXT 
NEXT 
LOCATE 24,1:PRINT ''Click for 2nd Window"; 
WHILE MOUSE (0)=0: WEND: WHILE MOUSE (0)<>0: WEND 
WINDOW 4, "New Window", (50,70)-{164,110),18,2 
COLOR 35,33:CLS 

LOCATE 1, ljPRINT"2nd One in HS" 
WINDOW OUTPUT 3 

LOCATE 24,1:?RINT "Click to Quit.,, 
WHILE MOUSE (0)=0: WEND 
LIBRARY CLOSE 
WINDOW CLOSE 4 
WINDOW CLOSE 3 
SCREEN CLOSE 2 
END 



•AC* 
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PD oof^endipita, 

Insight into the World of Freely Redistributable Software for the Amiga 



by Mike Morrison 



Fred Fish Disk #237 

CUPrint 

An example of printing both strings and 
numeric data to the CLI from as!>embly 
code. Includes source. Autlion Jeff Glatt 

CType 

A text file reader that is quick and small. 
Uses the current Preferences settings and 
the current font. There are also three file 
utilities StripCR, PlusCR, and StripLF to 
help in transfering files between different 
computer systems. Version 1.0, includes 
source in assembly. Author: Bill Nelson 

DPlot 

A program to display experimental data. 
The author outlines several design goals 
for future revisions including scaling. 
This is version 1,0. Author: A. A. Walma 

ILBMIib 

A shared library (ilbm. library) to read/ 
write IFF files, derived from the EA IFF 
code, along with various enhancements. 
Examples on using the library from 
BASIC, C and assembly included. Written 
in assembly, source included. Author: 
Jeff Glatt 

ParOut 

Assembly language code showing how 
to allocate and communicate direcdy 
with the parallel port hardware. Includes 
source. Author; Jeff Glatt (original C code 
by Phillip Lindsay) 

Speed 

A program that performs 10000 iterations 
of selected groups of 68000 in.stnjctions. 
The DateStamp time function is used to 
record how long the operations took. 
This number is then compared against 
known prestored times for a stock A2000 
and a A200 with an A2620 card. Version 
1.0, includes source in assembly 
language. Author; Jez San 



Fred Fish Disk #238 

CWDemo 

Demo-only version of the pop-up utility 
Custom Screens. The program allows you 
to control the color register assignments 
of Intuition custom screens. Version 3.1, 
binary only. Author: Kimbersoft 

DMouse 

A versatile screen & mouse blanker, auto 
window activator, mouse accelerator, 
popcli, pop window to front, etc, widget. 
Includes DLineArt, a screen blanker 
program that displays colorfitl line 
drawings. This is version 1,20, an update 
to version 1.10 on Fred Fish disk -169- 
Includes source. Author: Mart Dillon 

LabelPrint 

This program loads the directory off of a 
disk and then will print a disk label for 
you. Allows you to sort the directories 
and files in different ways. This is version 
2.5, an update to version 1.9 from Fred 
Fish disk #210. This program is 
shareware and includes binary only. 
Author: Andreas Krebs 

NGC 

A virus checker that checks the 
bootblock on all inserted floppy disks 
and reports nonstandard ones. The 
program also checks the jump tables of 
all resident libraries and devices and 
reports strange entries. This is version 1,0 
and includes source in assembly. Author: 
Ulf Nordquist 

Pyth 

A program to draw the Tree of 
Pythagoras. Version 1.1, includes source. 
Author: Andreas Krebs 

Steinschlag 

A Tetris like game submitted by the 
author. This js version 1,8, an update to 
version 1.5 from Fred Fish disk #221. 
Binary only. Author: Peter Handel 



Fred Fish Disk #239 

This disk contains Forth programs from 
the JGoodies #1 disk, from Delta 
Research (the makers of JFonh 
Professional 2.0). Below is a listing of 
subdirectories under JGoodies, and their 
contents. 

Brunjes 

Various tools submitted together by the 
author. StringPkg is string package for 
both Forth style and NUL terminated 
strings. Date & Time are handy tools for 
getting and printing formatted dates and 
times. Utils are utilities used by the other 
files, CursorControl is an example of 
moving the text cursor. SpaceOrEscape is 
a handy word for pausing or stopping 
program output. Includes source code. 
Author; Roy Brunjes 

Evolution 

This program draws bacteria as single 
pixels and then draws small bugs that eat 
the bacteria. The bugs mutate, compete 
for food, reproduce and pass dieir 
mutations to their offspring. An 
interesting program to watch. Standalone 
image and source code. Author: Russel 
Yost 

FFT 

Highly optimized Fast Fourier Transform 
tools for digital signal processing. The 
FFT can be used to compute the 
frequency spectrum of a complex signal. 
It is useful in a variety of different 
applications. Floating point and integer 
versions. Mixture of high level and 
assembly language code. Includes source 
(requires JFonh). Author: Jerry Kallaus 

Guru 

A program that explains the Guru 
number you receive when you crash 
your machine, CU usage only. Stand- 
alone image with readme file. Includes 
source code. Author: Mike Haas 
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THINKER 

ror AMIGA 

"..stunning capabilities, .simple to 
operate.." "..superbly crafted.." - 
Gary Gehman, Amiga Sentry, 6189 

Hypertext and Outline 

Processing combincd.( 

Powerful Hypenncclia 

application combines 

Word processing and 

database ideas into an 

Idea Processor. Link 

applications, pictures, text.^ 

Tlie latest technology for 

organizing information. Use Thinker 

for writing, designing, documenting, 

or as a database. 

New Features No Credit Cards 

$^ « rr CA res. add tax 

rt /Y Demo 3^ ^j^y guarantee 
O \J Disk $5 Add S5 for COD 

Poor Person Software 

3721 Starr King Circle, Uept 5 

Palo Alto, CA 94306 

(415)^493-7234 




Circle 127 on Reader Service card. 
H2J 

Converts *C' style '.h' include files to 
JForth style '.j' files. Useful when 
developing interfaces to new Amiga 
libraries like AKP, etc. Standalone image 
and source code. Author; Phil Burk 

HAMnuniu2 

A hypnotic line/box drawing program. 
Draws moving lines in a HAM screen 
and uses sound tools from HMSL if 
available, for 2 drone sound that 
con-esponds to the graphics image. 
Stand-alone image and source code. 
Author: Phil Burk 

HeadClean 

This program, combined with a fibre 
cleaning disk^ can be used to clean the 
heads on your disk drives. Source code 
examples of accessing the Trackdisk 
de\ice, and using gadgets are included. 
Stand-alone image with source code. 
Shareware. Version 2.0. Author: Phil 
Burk 

JustBeeps 

Simple example of using Audio and 
Timer devices. Plays a series of beeps 
whose pitches are based on a just 
intoned tuning system. Stand-alone 
image with source. Author: Phil Burk 



Mandelbrot 

A fast Mandelbrot rendering program chat 
uses some of the mathematical properties 
of the Mandelbrot set to greatly reduce 
the drawing time. Demonstrates graphics 
programming, assembly language, menus 
and IFF file I/O. Stand-alone image with 
source code. Autlior: Nick Didkovsky 

NeuralNet 

Example of Neural Net programming 
converted to JForth. Demonstrates a 
programming technique that many say is 
the wave of the future for software. This 
is a simple demo that shows neural 
propagation. Stand-alone image with 
source code. Author: Robert E. La Quay, 
ported by Jack Woehr 

Textra 

A small easy-to-use text editor that 
allows multiple windows, and provides a 
simple mouse driven interface. Has 
"Macintosh" like Cut, Copy and Paste 
commands. Stand-alone image. 
Documentation included. No source 
code. Author: Mike Haas 

Fred Fish Disk #240 

CrossDOS 

A "tryware" version of a mountable MS- 
DOS file system for the Amiga, This is a 
software product that allows you to read 
and write MS-DOS/PC-DOS and Atari ST 
formatted disks (Version 2.0 or higher) 
directly from AmigaDOS. This try^^are 
version is a "read-only" version, which 
does not allow any writes to the disk. A 
fully functional version is available from 
CONSULTRON. Version 3.02, binary 
only. Author: CONSULTRON, Leonard 
Poma 

Dis 

An AmigaDOS shareable library which 
implements a symbolic 
single-instruction disassembler for the 
MC68000 family and 
a program which uses the library to 
disassemble/dump AmigaDOS object 
files, making full use of symbolic and 
relocation information. Includes source 
code in Draco. Authon Chris Gray 

DM-Maps 

IFF maps to the Dungeon Master game. 
All 14 levels are included. Author: 
Unknown 



MemLib 

A link library of routines to aid in 
debugging memory problems. Works 
with Lattice C 5.0 and possibly w^ith 
earlier versions. It's features include 
trashing all allocated memory, trashing 
all freed memory, keeping track of freed 
memory with notification if it is written 
to, notification of memory freed twice or 
not at all, notification of overrunning or 
underrunning allocated memory, 
generation of low memory conditions for 
testing purposes, and identification of 
violations of memory use by filename 
and line number of the allocating 
routine. Includes source, Authon John 
Toebes and Doug Walker 

RixnBack 

This is version 6, an update to the 
version on Fred Fish disk #152. This 
version compiles under Lattice with 
many optimizations enabled, and can be 
made resident. Includes source. Author: 
Rob Peck, Daniel Barrett, Greg Searle, 
Doug Keller 

XprLib 

External file transfer protocol library. 
Document and code example for 
implementing external file transfer 
protocols using Amiga shared libraries. 
This is an update to the version included 
with the vit program on Fred Fish disk 
#226. Author: Willy Langeveld 

Fred Fish Disk #24l 

ASDG-ird 

Extremely useful shareware recoverable 
ram disk.This AmigaDOS device driver 
implements a completely DOS 
compatible disk device in memory that 
survives resets, guru's, and crashes. An 
absolute must for those with lots of ram. 
This is an update to the version released 
on Fred Fish Disk #58, It now works 
with up to 8Mb of memory. It was 
rewritten in assembly and is now faster 
and smaller. Binary only. Author: Perry 
Kivolowitz, ASDG Inc. 

CBBS 

The WORLI BBS system for use in 
amateur radio. Originally written for 
IBM-PC compatibles, it was ported to the 
Amiga by Pete Hardie. This is version 
6 Ac with source code. Author: Hank 
Oredson, the CBBS group, Pete Hardie 
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Fix68010 

A program which patches executables 

that fail to run on machines equipped 
with an M68010j so that they no longer 
use the prohibited priviledged 
instructions. Binary only. Author: Gregor 
Brandt 

Man 

A program similar to the UNDC "man" 
program. Displays information about a 
topic from manual pages. Does not 
include any database of topics, you have 
to supply your own. Version 1.2, 
includes source. Author: Garry 
Glendown 

NoCUck 

A program which silences the clicking of 
empty drives on the 32000 under 
AmigaDOS 1.3- It should also work on 
an A500. This is version 3.4, an update to 
the version on Fred Fish disk *231. 
Includes assembly source code. Author: 
Norman Iscove 

TUes 

A tile game similar to Shanghai or 
GunShy. A game board is covered with a 
set of 144 tiles, 36 different sets of 4 
identical tiles, each with a picture on it. 
The object is to remove all the tiles, 2 at 
a Ume, by matching identical tiles. 
Version 2.1, includes source in Modula 
11. Author: Todd Lewis 

Fred Fish Disk #242 

BootBlocks 

Detailed documentation on what a 
bootblock is and how it works, along 
with some sample bootblocks and a 
program to install a custom bootblock. 
Includes source for the sample 
bootblocks and the install program. 
Author: Jonathan Potter 

Check4Mem 

Allows you to check for a specified 
amount of memory, with certain 
attributes, from a batch file. If the 
requirements are not met, a WARN 
returncode is generated. Version 2, 
includes source. Author: Jonathan Potter 

CustReq 

A glorified ASK command for your 
startup-sequence. It generates a requester 
with the specified title, text, positive and 
negative gadgets (either of which can be 
the default), and an optional timeout 
value. Version 2, includes source. 
Author: Jonathan Potter 



FileReq 

This is Jonathan's second version of a file 
requester, and is much more powerful 
than the one included on Fred Fish disk 
#204. Shareware, includes source. 
Author: Jonathan Potter 

FullView 

A text viewer that uses gadgets at the 
bottom of the screen (thus can display 
text 80 columns wide), opens up to the 
full height of the workbench screen, has 
fast scrolling, and can work with 
compressed files (file compression 
program included). Shareware, binary 
only, source available from author. 
Author; Jonathan Potter 

Image-Ed 

An icon editor that allows you to draw 
and edit images up to 150 by 90, in up to 
l6 colors. Allows freehand drawing, 
empty or filled rectangles, ellipses, and 
triangles, lines curves, and polygons, 
copy, flip about x or y axis, stretching 
and condensing, flood fill and 
complement, text with selection and 
loading of font style, undo, magnified 
and normal sized images, and two active 
drawing screens at once. This is version 
2.2, an update to version 1.9 on Fred 
Fish disk #211. Binary only, source 
available from author. Author: Jonathan 
Potter 

JAR 

Jump And Run is game using 3-D 
graphics. Your task is to collect the blue 
pills lying on the floors and steps, not to 
fall down or off the steps, and to avoid 
several monsters wandering about. You 
can collect various sorts of weapons to 
use against the monsters. This is version 
1.0 and is shareware. Binary only, source 
available from author along with a game 
editor. Author: Andreas Ehrentraut 

JPClock 

A short clock program that is just packed 
with features. This is version 1.2, an 
update to version on Fred Fish disk 204. 
Includes source. Author: Jonathan Potter 

PPrefs 

A replacement program for Preferences. 
Preferable Preferences is a program that 
is shorter, more efficient, and easier to 
use than the standard Preferences. Binary 
only. Author: Jonathan Potter 




ALF 2 

Amiga Loads Faster 

Increased speed, safety, & 
efficiency on the Amiga. 



I hard disk controller with software 
I autobootable - 400 kB/sec 
I safer witfi CfieckDrive 
I faster with FastFileSystem 
I 50% more MB with RLL-contro!)er 
I uses any IBM-compatible HD- 
even defective hard disks 
I SCSI-Bus. ST412/ST506-BUS 



Pre ' sped Technics Inc. 

RO. Box 670. Station H 
Montreal, Quebec H3G 2M6 
Phone: (514) 954^1483 
Fax: (514)876-2869 

BSC Buroautomatlon GmbH 

Postfach 400368 

8000 Munchen 40 West Germany 

Phone: (89) 308-4152 

Fax: (89) 307-1714 



Circle 165 on Reader Service card. 

PaletteReq 

A palette requestor that allows you to 
change the color of any screen from 
within your program. Includes source. 
Author: Jonathan Potter 

Poplnfo 

A utility program which gives you 
information about ±e status of your 
devices and memory. The window can 
pop up or go away to save space. This is 
version 3-1, an update to version 3.0 on 
Fred Fish disk 223. Includes source. 
Author; Jonathan Potter 

ZeroVirus 

A virus checker that saves and restores 
bootblocks. Will find both bootblock and 
file based viruses. This is version 1.3, 
binary only. Author: Jonathan Potter 

Fred Fish Disk #243 

Fragit 

A dynamic memory thrasher for the 
Amiga. Fragit randomly allocates and 
deallocates psuedo-random size values of 
memory, ranging from l6 bytes to 50000 
bytes by default. The result is an 
allocation nightmare, thousands of 
memory fragments are being created and 
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destroyed continuously. This puts stress 
on the memory allocation routines of an 
application undergoing testing by 
simulating a very busy, highly 
fragmented memory environment. This is 
version 2.0, featuring many bug fixes, a 
full intuition interface, configuration 
settings via the icon, and more. Includes 
source. Author: Justin V. McCormick 

ImageLab 

A program which performs image 

processing on IFF pictures. Includes 
standard image processing functions 
such as convolution, averaging, 
smoothing, enhancement, histograms, 
FFT's, etc. Also includes file conversion 
functions, a clipboard, and other useful 
functions. Version 2,2, binary only. 
Author; Gary Milliorn 

LPE 

LaTeX Picture Editor is a graphical editor 
for producing '^pictures" for the LaTeX 
system, which may be imported by 
LaTeX. You can draw boxes, dashed 
boxes, lines, vectors, circles, boxes with 
centered text, and plain text. This is 
version 1.0, binary only. Author: Joerg 
Geissler 

NoCHck 

A program which silences the clicking of 
empty drives on the B2000 under 
Amiga DOS 1.3. It should also work on 
an A500. This is version 3.5. a last minute 
update to version 3.4 on Fred Fish disk 
#241. Includes assembly source code. 
Author: Nomian Iscove 

Password 

A program to help secure your computer 
with password protection that is 
complicated enough to keep out most 
casual or non-technical users. You can 
get a cutom setup from the author if you 
send him your startup-sequence. Version 
1.21p, binary only. Author: George 
Kerber 

Pcopy 

An icon driven copy program that is 
faster than diskcopy. Has several 
different modes including automatic 
which will start to fonnat a disk as soon 
as it is put into the drive. This is version 
2.0, a highly upgraded rewrite of the 
version on Fred Fish disk ^151- Binary 
only. Author: Dirk Reisig 



SimGen 

This program will add a 2 or 4 color 
picture to your WorkBench screen. If the 
picture is digitized, ii will look much like 
a genlock, hence the name SimGen 
(Simulated Genlock). Binaiy only. 
Author: Gregg Tavares 

Superlines 

A new lines demo with a realtime control 
panel that you can use to change various 
aspects of the action. Has 10 built in 
color palettes, color smudge, color 
cycling, color bounce, multiple 
resolutions, and can display either lines 
or boxes. This is version 1.0, binar>' only. 
Author: Chris Bailey 

WarpUtU 

This directory contains three programs 
for file compression: Warp (version 1.11), 
UnWarp (version 1.0), and WarpSplit 
(version 1.1). Warp reads raw filesystems 
and archives them into a compressed 
version in a normal file. UnWarp turns 
them back into filesystems. WarpSplit 
splits them up into smaller pieces on a 
track by track basis. Binary only. Authon 
SDS Software 

Fred Fish Disk #244 

BBChampion 

This is a very nice program that allows 
you to load, save, and analyze any 
bootblock. This is version 3-1, binary 
only. Author: Roger Fischlin 

Bootlntro 

This program creates a small intro on the 
bootblock of any disk, which will appear 
after you insert the disk for booting. The 
headline can be up to 44 characters. The 
scrolling text portion can be up to 300 
characters. This is version 1.2, an update 
to version 1.0 on Fred Fish disk #188. 
Binary only. Authon Roger Fischlin 

FMC 

An program to turn fast memory on or 
off. Similar to the NoFastMem program. 
Version 1.2, includes source in assembly 
code. Author: Roger Fischlin 

SizeChecker 

Size Checker uses a file created on any 
editor to check any file to make sure it is 
the correct size. It can be used to spot a 
link virus or lo point out changes in the 
configuration of your system. If you use 
comments added to your size list, you 
can check to see what version of the files 
you are using (1.2, 1.3, 1.4, ARP. etc). 
Version 1.0, binary only. Author: Roger 
Fischlin 



TextDisplay 

A text display program, like "more" or 
iess", but about half the size and 
handles all screen fomiats (FAVNTSC, 
interlace/non-interlace, etc). This is 
version 1.52, an update to version 1.1 on 
Fred Fish disk ^188. Binary only. Author: 
Roger Fischlin 

XColor 

A program that lets you change tlie 
colors of any screen. You can also add 
and subtract bitplanes in the screen, or 
convert the screen to black and white 
(grayscale). Handles FIAM and EHB 
screens. Version 1.2, includes source in 
assembly code. Author: Roger Fischlin 

Fred Fish Disk #245 

ATOF 

A small utility that allows you to use the 
fonts of another disk without using the 
CLI. Version 1.0, binary only. Authon 
Roger Fischlin 

Bootlntro 

This program creates a small intro on the 
bootblock of any disk, which will appear 
after you insert the disk for booting. This 
is the "next generation" Bootlntro, a 
more colorful version than the one on 
Fred Fish ^disk 244, but the text must be 
shorter. The first line can be up to 24 
characters. The second and third lines 
can be up to 22 characters. The scrolling 
text can be up to 98 characters. Binary- 
only. Authon Roger Fischlin 

Fenster 

A program which can operate on 
windows owned by another program, to 
close them, change their size, refresh 
gadgets, move the window to the 
background, etc. Version 1.0, includes 
source. Author: Roger Fischlin 

PathM aster 

A file requester with lots of features. 
Can be easily configured by the 
programmer to suit a variety of 
applications. Includes source. Author: 
Justin McCormick 

Reversi 

Plays the classical reversi game on an 8 x 
8 square field. Version 1.2, includes 
source in assembly code. Author: Marc 
Fischlin 
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icroMiga 



Phone: (619) 670-3161 
DBS: (619) 670-1095 
TAA: (619) 670-9732 

Mail: P.O. 50A 2104 
La Mesa. CA 92044 



HaLdwBLe: 




SDJiwam: 






A-Max Mac Emulator 


$128 


Datastomi 


$26 


At MicroMiga, our customer and 


Air Floppy Drive (Inl/Ext) 


$128/$ 149 


Digi-Paint HI 


$67 


their Amiga are Number One. We 


California Access Drive 


$149 


Lords/Rising Sun 


$33 


carry a full line of Amiga Products 


Digi-View Gold 


$135 


MusicX 


$175 


from Hard Drives to Genlocks and 


Dual Serial Port Board 


$234 


Pagestream 


$129 


Games to Business Software all 


Flash Card 


$187 


Pen Pal 


S88 


discounted well below retail! We 


GVP '030 W/4MB & 68882 


$2,500 


RawCopy VI. 3 


$39 


also support our customers with a 


Hardfraine DMA SCSI 


$250 


Sculpt/Anim. 4D 


$402 


simple return policy and friendly 
sales people who know the Amiga. 


Phoenix Exp. Chassis W/Pwr 


$211 


Vortex 


526 


Supra 2400 Modem 


$135 


Populous 


$35 




Genlocks 


$Call 


And a Ion more! 


circle 182 on Reader Service card. 


Call Or Write For A Free Catalog Of Over 


1 too Amiga Products! 


Yls( 


3^8dMbs.terCard^AIJ^lQ_.MditiQnalJIli^^ 











Vlt 

This is a binary update to the vlt 
program on Fred Fish disk #226, and 
fixes a problem with external protocol 
support. You still need the rest of the 
files from Fred Fish disk *^226. Version 
4.065, binary only. Author: Willy 
Langeveld 

Fred Fish Disk #246 

Dmake 

Release version 1.0 of Matt*s version of 
the UNIX make utility. Update to beta 
version released on Fred Fish disk #179. 
Features multiple dependancies, wildcard 
support, and more. Binary only. Author: 
Matt Dillion 

labelPrint 

A program that allows you to easily print 
labels for your disks. This is version 
2.5b, an update to version 2.5 from Fred 
Fish disk -238. Shareware, binary only 
(source available from author). Author: 
Andreas Krebs 

NConiin 

A terminal program for the Amiga based 
on comm version 1.34. Has hot keys for 
most program functions (including 



dialing up to 10 phone numbers), PAL 
and NTSC support for normal or 
intedaced screens, screen I/O greater 
than 2400 baud, ANSIATIOO terminal 
emulation with full 8 color text support, 
IBM graphics, optional o-anslation styles, 
split screen mode, full user control of 
color palette, full support for all 
European languages, full serial port 
control with baud rates up to 19,200, 
script language, phonebook, keyboard 
macros, and more. Version 1.8, binary 
only. Author: DJ James, Daniel Bloch, et, 
al. 

NoClicfc 

A program which silences the clicking of 
empty drives on the B2000 under 
AmigaDOS 1.3- It should also work on 
an A500. This is version 3-6, an update 
to version to version 3.5 on Fred Fish 
disk #243. Includes assembly source 
code. Autlior: Norman Iscove 

ScreenShare 

A librar^^ and support programs that 
enable applications to open up windows 
on other applications' custom screens. 
For example, your editor may want to 
open a window on your terminal 
emulator's screen so you can compose a 
message while still being able to see the 



contents of the terminal's screen. Both 
applications must cooperate for the 
screen sharing to work. Version 1,2, 
includes source for interface portions. 
Author: Willy Langeveld 

Ty 

A text display program based on Amiga 
"less" version 1.0. Has both keyboard 
and mouse control of all functions, an 
intuition interface, and uses the Amiga 
specific keys (such as the Help key) 
correctly. Version 1.3r includes source. 
Author: Mark Nudelman, Bob Leivian, 
Tony Wills 

Fred Fish Disk #247 

Analogjoystick 

Software support for use of analog 

joysticks on the Amiga. Includes a driver, 
a header file for code that calls the 
driver, and an example program that 
uses the driver. Includes source. Author: 
Dave Kinzer 

AssemTools 

A collection of files which should be of 
great interest to Amiga assembly 
language programmers. The collection 
includes 140 macro routines which make 
assembly language programming a lot 
easier. There is also a library of routines 
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containing buffered C4ike file handling 
functions (fopen, fclose, fgets, fputs, etc) 
and a file name requester. All routines 
are re-entrant. Includes source for 
example programs using the macros and 
library, and a 65c02 cross macro 
assembler. Authon Jukka Marin 

RemoteLogin 

A couple of programs which make 
possible remote access to your Aitiiga, 
One program checks the serial port for 
an incoming call, and starts a program 
when it is detected. The other is a 
password protection program which 
allows starting various programs based 
upon login id, thus providing some 
minimal security for your computer. 
Includes source. Author: Dave Kinzer 

Xprlib 

External file transfer protocol library. 

Document and code example for 
implementing external file transfer 
protocols using Amiga shared libraries. 
This is version 2.0, an update to the 
version on Fred Fish disk #240, with 
many extensions and enhancements. 
Includes sample XPR library and source. 
Author: Willy Langeveld 

Fred Fish Disk #248 

AmlGantt 

A project defmition and management 
tool designed to create a simple, 
interactive method of outlining the task 
required to complete a particular project, 
using the GANTT chan as the input 
format. AmiGantt displays the project in 
a multi-window mode with separate 
windows for the GANTT chart, task 
information input, resource histogram 
display, and Pert chart display. Up to 500 
tasks may be defined for any project, and 
a project may contain other projects as 
tasks. Version 3*0.0, shareware, binary 
only. Author: Donald Tolson 

CU-Colors 

A simple little program to change the 
colors of the border around a CLI 
window. Includes source in assembly 
code. Author: Michael Sinz 

Flipper 

A small, fast, Othello program. Does not 
use any look-ahead methods. Binary 
only. Authon Michael Sinz 



Maze 

An example of a fully re-entrant maze 
generation program written in assembly 
language using Manx's assembler. 
Includes source. Author Michael Sinz 

NetHandler 

The Software Distillery's netu^ork file 
system handler (NET:), using Matt 
Dillon's DNET to mount one Amiga's 
devices on another Amiga. It also serves 
as an example file system written entirely 
in Lattice C, Version 1.0, includes source. 
Author: Software DisiHlery 

Regex 

An Amiga shared library version of the 

GNU regular expression package from 
the Free Software Foundation. A regular 
expression is a concise method of 
describing a pattern of characters in a 
string. By use of special wildcards, 
almost any pattern can be described. A 
regular expression pattern can be used 
for searching strings in such programs as 
editors or other string handling 
programs. Version 1.0, includes source. 
Author: Edwin Hoogerbeets, FSF, Jim 
Mackraz 

Fred Fish Disk #249 

Automata 

Four cellular automata programs, 
AutomaTron is a one dimensional 
cellular automation, Crud is a automation 
based on a sum index rule, Demon is a 
cyclic space automation described in the 
Aug 89 Scientific American, and Life is 
one of the oldest and best known of all 
cellular automata. Includes source. 
Audion Gary Teachout 

Slicer 

Sheer computes and displays images of 

the Mandelbrot and Julia sets. Unlike 
many Mandelbrot programs that generate 
pictures directly, Slicer computes and 
stores an array of raw data which it may 
then render into pictures in a number of 
ways. Version 1.0, binary only. Author: 
Gary Teachout 

TurMite 

A two dimensional taring machine 
simulator. Imagine a small bug crawling 
around on your computer display 
moving one pixel at a time. At each step 



it uses its internal state number and the 
color of the pixel it's on as indexes into a 
set of tables to decide what color to 
change the pixel to, what direction to 
move, and what its new internal state 
should be. Includes source. Authon Gary 
Teachout 

Fred Fish Disk #250 

ASlmplex 

An implementation of the Simplex 
algorithm for solving linear programs. It 
uses the standardized MPSX-format for 
input data files. This is version 1.5, an 
update to version 1.2 on disk 199- 
Changes include bug fixes, the ability to 
run from CLI, it's own window for I/O, 
and some new and improved commands. 
Includes source. Author: Stefan Forster 

Gravity-Well 

A celestial motion simulator that 
simulates the motion of up to twenty 
bodies in a Newtonian universe. The 
view of the simulation may be scaled, 
rotated in three dimensions or 
repositioned. Includes source. Author: 
Gary Teachout 

Paranoids 

An asylum escape game. Paranoids is a 
traditional board game played by 
drawing cards, rolling dice, and moving 
pieces around the board. Each player has 
SIS pieces, four patients and t^^o doctors. 
The object of the game is to get all of 
your patients out of the asylum. This is 
version 1.0, binary only. Author; Richard 
Anderson and Gar^^ Teachout 

RPSC 

A reverse polish scientific calculator. 
RPSC is a programmable RPN calculator 
in the Hewlett-Packard tradition. It 
supports operations with real numbers, 
complex numbers, matrices, and 3-D 
vectors, as well as storage and recall of 
labeled variables. Data and programs 
may be saved, loaded, or written as 
ASCII text, to AmigaDOS files. This is 
version 1.1, binary only. Author: Gary 
Teachout 

•AC* 
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fAOr fKACTAL^ 

Generate Mandelbrot Fractals at Lightning Speed 



by Hugo M.H, Lyppens 

Introduction 

This article presents FastFractals, a fast 
fractal generating program. It takes a fraction of 
the time usually considered "necessar)^" to pro- 
duce fractal images. It's so powerful that even the 
most impatient reader can explore and enjoy the 
beaut>^ of fractals. 

Some Theory 

This program generates the well-known 
Mandelbrot class of fractals. The propenies of 
Uiese fractals are best described witli tlie help of 
complex numbers. Complex numbers are a natu- 
ral extension of the real numbers. Real numbers 
lie on a line and complex numbers correspond to 
points on a flat plane. Operations on a complex 
number can be viewed as an operation on a 
vector beginning at the origin (0,0) and ending at 
die point Cvj') unique to that number. 

The decisive step in complex arithmetic is 
the introduction of tlie so*called "imaginary" unit, 
L The Cartesian coordinates ix,y) mentioned 
above are used to express the form of a complex 
number as follows: 2r = x + >'/., where a: is called 
the "real" part of z, and y is called tlie "imaginary" part of z. With 
complex numbers, multiplication can be done as usual, provided 
the nale i^ = -1 is used. The addition of two complex numbers is 
done by adding the real parts togetlier and adding the complex 
parts together. Here are some examples: 

(2 + 30(3-40 - 6 + i-12f-= 6 + /- 12C-1) = 18 + / 

(2 + 30 + (3-40 = 5-/ 

(a + biXc + di) ^ ac- bd+ (ad + bc)i 

ia + bO + ic + di) = a + c -i- (b + d)i 

^ - (a- + yi)- = X- - f + 2x}n 

Mandelbrot discovered the result of die complex function/ 
z/E z^+ c when applied iteratively. The variable cis a given stardng 
point and the value to which zis initially set. When tlie transforma- 
tion is applied to this initial z, tlie result is tlie complex number Jtz), 
which is called z^. Another transformation gives Jtzp, written z^. 
Continuing in this manner yields the array z, z^, z^, z ,.,., z^, which 
is called the "orbit" of z. 

When tlie orbit of an arbitrary^ number z is examined, it is 
generally found tliat after a certain number (?0 of iterations, the 
point representing z travels beyond a distance of 2 from the origin. 
(The distance from the origin to zcan be calculated easily using the 
Pythagorean theorem: with z= .s:+ j'/, the distance is ix^+y^^^^, or 
abs(z).) The number 7i is called die '*index" of z. This means that 
2(n) lies outside the circle, while 2(n - 1) lies inside. However, tliere 
exists a special set of points whose indices are formally infinite. That 




is, their orbits He completely inside the circle. This set is called the 
Mandelbrot set, and it has a very characteristic shape. 

When the program encounters a point of the Mandelbrot set 
and tries to calculate its index, it will, in principle, never finish. 
That's why a finite number of iterations (« = iter) needs to be 
defined, limiting the number of times the program executes the 
transformation loop. The algorithm will stop after it is executed n 
times, even if the point has not traveled outside of the circle. This 
way, the result of the index calculation is guaranteed to be in the 
interval [0, iter]. 

To produce the fractal image, the program scans all points on 
die screen, from die top left to die bottom right. For each associated 
complex number, the index is calculated, and to get a colorful 
result, this value is mapped to a color value and plotted on the 
screen. 

The number of iterations greatly influences the amount of 
detail. If n= 1, a circle of radius 2 is produced. As w increases, the 
edge of die Mandelbrot set becomes sharper. However, there is a 
tradeoff; More iterations also means longer execution time, as die 
transformation is executed more often. A value for n which quickly 
produces nice results is 40. 

Using FastFractals 

FastFractals opens a lo-res five-plane custom screen. It starts 
by displaying a palette of colors at the top of the base picture which 
shows the Mandelbrot set in dark blue. It has a small user interface, 
with two menus: 
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The Task Menu contains the following options: 

Draw Fractal: Redraws the fractal. 

Zoom: For this function to work, tlie user must create a box 
around the area to be zoomed in on. Click the mouse 
button at the top left comer and drag the mouse. 
Release at the bottom right comer. If tlie box is not 
satisfactory^ this operation can be repeated. The 
previous position is stored in the zoom stack, so the 
user can later UnZoom. 

UnZoom: Returns to the previous position stored at the top 
of the zoom stack. 

^Iterations: Brings up a requester allowing the user to set 
the desired number of iterations. 

Color Mapping: Addresses the problem of mapping from 
index values to color numbers. Index values can 
range from to iter, whereas color numbers range 
from to 31. This function brings up a requester that 
contains 32 integer gadgets, one for each color. 



Mapping example 


C#Iterations = 100): 


13 


14 


1 15 


2 16 


3 17 


4 18 


5 19 


6 29 


7 39 


8 49 


9 59 


10 69 


11 80 


12 90 


12 100 


12 101 


would mean: 


index zE use color 2 


index 1 JE use color 3 


indices 80-89 


M use color 29 




^T^LS}^^ 


Afastfractal 




captured in 




action,,. 


^^^^^^^^^^^^ 




indices 90-99 ^ use color 30 

index 100 v^ use color 31 
So color n is used for a pixel if its index map( n-V) and < mapCn). 
Color Palette: Invokes a requester to set the palette. 
Quit: Quits the program. 

The Screen Menu allows the user to select the desired screen size. 
The Tiny option is handy for a quick overview of what a 
picture will look like. It takes effect the Tusi time a fractal 
is drawn after its activation. Created images can be saved with one 
of the screen-grabbing utilities. 



Inside The Program 

The program consists of two parts: a C part and an assembly 
language part. The C part sets everything up, manages the user 
interface, and cleans up to allow for a graceful exit. The actual 
fractal-drawing program is in assembly language, and gets its in- 
structions from the C program. 

The following is pseudocode for the fractal routine: 

loop Y;/*Along interval given by main program: Initially -1.0 to 

l.OV 

loop X;/*Same, initially -2.0 to 2.0*/ 

coynter=0;XZ-X;Y2=Y; 

innerloop: XZK=X^-YZK-YZ; 

if counter>#Iterations or XZK+YZK>4 then quit innerloop; 

YZ-(YZ) (XZ)^+Y;XZ-XZK-Y2K-»-X; 

/^Because transformation is zi°tb and 2=XZ+YZi and c=X+Yi 

2^+C= (XZ+YZi)?+X+Yi=XZj-YZ>X+ (2'XZ*YZ + YK*/ 

counter=counter+l ; 

end innerloop; 

plot (X, Y) , color (counter) ; 

/*Look up color number corresponding to index found.*/ 

end loop X; 

end loop Y; 

done. 

How are fast fractal renderings obtained? Take a look at the 

algorithm. It seems that there isn't a shoncut; all the transformations 

have to be repeated for every point. There's nothing to gain here, 

A better way to improve speed is to avoid floating point 

caiculaUons. Since the Amiga doesn't have a numeric co- processor, 

floating-point operations are imple- 
mented via library routines, which 
are slow compared to the integer 
aritlimetic of the 68000. The micro- 
processor has a built-in multiplier 
for integers. Why not use this? Al- 
though fractal calculations aren't 
iiiteger calculations, integer arith- 
metic can be used. 

This is done using a special 
number representation, the fixed- 
point representation. In the 1 6-bit 
representation, the upper 4 bits are 
tlie signed integer part, while the 
lower 12 bits are the fractional part. 
So, the precision is 1/4096, 
since 1«12 = 4096, For example: 

$1,800 = 1.5 as $800/$1000 = 0.5 

and 

-$2,400 = -2,25 as $400/$1000 - 0.25 
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The normal MULS.W instruction can be used on these 
numbers: 

$1,800 • -$2,400 - -$03.600000 

Shift this to the right 12 bits: -$3.600, which in fioating-point is - 
3,375. The code of this is in the assembly listing, labeled "algolo" 
(for Algorithm Low Precision). Notice the correspondence between 
the pseudocode and the machine code. 

When the zoom function is used to get deeper into the fractal, 
tJiis precision is not enough. When the program notices this, it 
switches to an extended, 32-bit representation. The integer part is 
Still 4 bits, so the fractional part becomes 28 bits. The reason why 
this representation is not used all the time is that it is much slower 
than its 1 6-bit counterpart. MULS.W can handle only 1 6-bit num- 
bers, so a way must be found to break the 32-bit multiplication into 
manageable l6-bit pieces. For example let's try to calculate 1.2 • 
2.25 (- 2.7): 

$13333333 * $2.4000000 - $1,353 * $2,400 + $0.0003333 * $2,400 + 
$1,333 • $0.0000000 - $2.b32c000 + $0.007332c + $0.0000000 = 
$2,b39B2c. 

Since $b39f32c/$ 10000000 - 0.7, the answer is right. This large 
multiplication was broken down into 3 smaller (1 6-bit) multiplica- 
tions by multiplying the upper words of both numbers, then the 
lower word of one number and the upper of the other, and then 
vice versa. To be exact, one would want to multiply the t^^o lower 
words (in tliis case, $3333 and $0000) too, but it isn't worth the 
trouble, as this would add next to nothing to the precision. The 
code of this is in the assembly listing under "algohi" (Algorithm 
High Precision). 

The Assembly Listing 

The C program allocates the display planes as a contiguous 
block of memory. In this way, the assembly program doesn't have 
to work with five plane pointers or look them up in the BitMap 
structure. All it takes now is one pointer register and a different 
offset for each plane. 

The information from the Color Mapping Requester is trans- 
lated into an array of color numbers. An index value can then be 
mapped to a color value just by looking it up in the array. As the 
maximum number of iterations is 256, the an-ay has room for 257 
elements. The color is brought to the screen by shifting it to the right 
5 times. The first bit tliat comes out is shifted into PlaneO, the second 
in Plane 1, and so on, for all 5 planes. 

The list of variables is at the bottom of the listing. The first is 
V, the address of which is put into a6 at the start of the program. 
AU variables are accessed relative to a6 by using the Address 
Register Relative addressing mode in this way: Variable- t<A6). It has 
the same effect as using Variable in an absolute sense, but it's 
shorter by 2 bytes (and faster). 

A few of the variable names are preceded by an underscore. 
These are exported, so that the C module can access them. By using 
these variables, parameters don't have to be passed via the stack 
anymore. 

neC listing 

The C listing is more straightforward. However, it is quite 
instructive. It shows how to do IDCMP, how to use Menus, 
Requesters, Integer Gadgets, and Proportional Gadgets, and liow 
the interface to Machine Language works. 




^ the MS-DOS 
File System 
for the 

COMMOPODE 



AVAILABLE NOW FOR 
THE LOW PRICE OF 

^3000 (US) 
$3600 (CDN) 

CrOSSDOS'^. . . MS-DOS® DISK ACCESS DONE RIGHT! 



The first MS-DOS File System for the Amiga* 

• Kcjd^ LH v^^uc^ any ^WIK or 72nK MS rK)S ot ATARI ST'' disks 

(M-f-Hion 2 (I t»r higher! i*ith opiional k-vi Hie rilicr\ 

• Trjnsf jmuly diccc-^scs MS DOS ftlrs from an> utiliiy or ipplicarum 

I including (lie rcqucsicfN). 
ft Fully miirtrares itself mm tht Amiga operaiing sysicm, 

• Automaikilly readjust to different MS DOS/ATARI ST foimats. 

• Can be rciTHived aficr uve to reclaim memtiry, 

• Provides an easy in'.rQllatinn pragTam, 

• Aviuli.ihlc in \i RE- AD-ONLY version from the rublit [)t>ni;»in or 

dirculy Irimi CONS ULTffOW for only S5.(K), 

For orders placed thrxiuph CONSULTflOW add SHH> Nhipping and 
handlmp iSKlX) o*ji^)dc the L S, and Canada) Michigan tcsidenis musi 
add \ht correct %jlcs lin. C O D. add S3 00 



In ADDtTUtN 1(1 reading 
and wntin^ anv lilc tifl 
an MSIKJS disk, 
pcrtorm the fol liming 
DflS I unci ions on files 
and dtr^iories, 

+ Scan any diftciory 

* Create directories 

* Rename 

* t>cleie 

* Set dales 

* Set protection bits 

* Seek file positions 

* Get disk infomuiion 

* Add cache buffers 



Send (, bet k or money order to: 

Please allow up io 2 v^et'ks to 
proce>"*yt>ur Older 

(leatvr inquiries wrlcome. 




C0NSUL7TOW 

Techntcai Support 
(313)459-7271 



1l280ParKvteA 

Plym juih. Ml 481 70 



Amga 



K US4X3S41 



ftffgyec 



fjDmi^ gi Udsof. re Aim ST s a 



TjgaifKi' 



raasp'jrt o^Aim Corp. 



Circle 156 on Reader Service card. 

I also used some tricks for tht- lattice Compiler to reduce the 
code size. The first is not to link witli any stanup code. As a result, 
tlie program has to set up SysBase and DOSBase itself. Another trick 
is to use base-relative addressing and function calls (the -b and -r 
option). The -v option, which disables stack-checking, also saves 
hundreds of bytes. When using the proto includes, the compiler 
generates jn-line function calls and avoids the stub functions, which 
are otherwise pulled in at linking. It is also important to use the 
SmallCode, SmallData and NoDebug flags on BLink. 

This way, it is possible that the code size of a program like 
this will list at an amazing 10 Kbyte. Even the Calculator is bigger! 

Compiling, Assembling And Linking 

Once yoti've typed in both sources, proceed as follows: 

LCI -b c^vf fractal 

LC2 -r -V -y fractal 

Assem fractal .asm -o fraaal.obj 

BLink fractiil.o/ractaLobjTO fractal ND SC SD LIB lib/amiga.lib, 

lib/lc.Hb 

The Compiler used is Lattice C Version 4.0. Aztec C users probably 
should erase the proto -include's and use normal stamip code. The 
a.ssemb]er used is the AmigaDOS Macro Assembler. 

Conclusion 

I hope you'll become a fractal freak like me! Once you get the 
hang of it, you might even decide to substitute the Mandelbrot 
fractal formula with your own. The program offers an excellent 
basis for experimenting with other IV)rmulas. There are so many ol 
them. Good luck! 
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W« take a ^ out of the price 




ONE BYTE 

P.O. 00x455 

Qoak«r Hill a 06Xr5 

(SOO) AAl-eYTE. in CT (203) 443-46Z3 



Authorize doater for 

CoininodorQ^niigq Compotvrs, 

GnratVail«y Products (GVP). 

Memory & Storog« Technology (M.fl.S.T.). 

Authorized Commodore^niiga Service ond Repoir. 

Authorized Amiga Graphics Dealer. 



AMIOA IS A REGISTERED TlftADEMABK OF COMMODORE-AMIGA. INC 



addi.w fPLSlZE*2,dl 
add^w dl,dO 
adda.w dO^aO 



movein.i sx-v{a5) ,d0-d3 ; get sxysy/sw/sh 

sub.l d3,dl 

move.l dl,yc-v{a6) 

sub.l d2,d0 

move.! d0,xc2-v(a6) 

movem^w fw-v (ao} , d4/d5 ,-fw/fh 

move .1 d2 , dO 

move .1 d4 , dl 

jsr _GXD33(PC) 
*_CXD33 is a Ic.lib routine to do a long division: dO:=dl/dO 

move.l d0,xcd-v(a6) 

cmpi.l IS20000,dO 

slt.b algo-v(a6) ;is it necessary to shift to High 
;Precislon? 



Circle 135 on Header Service card. 



SCREENW 


equ 


320 


SCREENWB 


equ 


SCREENW/ 8 


SCREENH 


equ 


200 


FWIDTH 


equ 


256 


FWIDTHB 


equ 


FWIDTH/ e 


FHEIGHT 


equ 


128 


PLSIZE 


equ 


SCREENWB*SCREENH 


ITER 


equ 


100 


PEHI 


equ 


28 


PR 


equ 


12 


'MGRENS 


equ 


{26«(PR-4)) 


«GRENS 


eou 


(41«(PR-4}) 


WGRENSHI 


equ 


(32«(PRHI-4)» 


GRENSHI 


equ 


{64«(PRHl-4)) 


WGRENS 


equ 


(32«(PR-4n 


GREMS 


equ 


(64«(PR-4)) 


XZ 


equr 


d2 


YZ 


equr 


d3 


XZK 


equr 


d4 


Y2K 


equr 


d5 



section text, code 
Kdef _Fractal 
xref CXD33 



Fractal movem.l 
lea 

move.w 
sub.w 
Isr w 
move.w 



dl-d7/aO-a6,-(a7) 

v,a6 

# SCREENW/ 2, dO 

fw-v(a6) ,dO 

#2,d0 

dO, modulo- v(a6) 



value to be added to pointer after each line 

movea.l _fi-v{a6),a0 

move . w # S CREENH / 2 , dO 

sub.w fh-v(a6) , dO 

mulu.w #SCREENWB,dO 



move*w 

Isr.w 



modulo-vta6) ,dl 
#l,dl 





move . 1 




d3,d0 








move . 1 




dS.dl 








jsr 




CXD33(PC) 








move , 1 




d0,ycd-v{a6) 








cmpi . 1 




#$20000, dO 








slt.b 




dl 


is it necessary to shift to High 










;Pr 


ecision? 




or.b 




dl,algo-v (a6) 








add.w 




d5,d5 








move.w 




d5,vcount-v [a6) 






asr.w 




#4-1, C4 








move . w 




d4,hcount2-v{ 


a6) 




vlus 


move . w 




hcount2~v (a6) 


, hcount 


-v(aC) 




move . 1 




Kc2-v(a6) , xc- 


v(a6) 




hlus 


move . w 




#lG,hcouncl6- 


v{a6) 


;to count nhe bits of a 
; screen word 


h21us 


cir.w 




dl 




;COUNTER=0 




move . w 




iter-v^aS) , do 




;get fiterarions 




move . 1 




xc-v(a6),XZ 








move . 1 




yc-v(a6),YZ 








tst.b 




algo-v(a6) 




; choose low or high 
; algorithm 




beq.l 




algolo 






algohi: 










;high precision 


Ihi 


cmpi 


. 


# WGRENS HI, 


XZ 






bge. 


1 


klaar 








cmpi 


.1 # -WGRENS HI 


,XZ 






ble. 


1 


klaar 








cmpi 


.1 tWGRENSHl, 


YZ 






bge. 


1 


klaar 








cmpi 


. 1 # -WGRENSHI 


,YZ 






bXe, 


1 


klaar 








Cmp. 


w 


d6,d7 








bge. 


1 


klaar 








rst. 


1 


XZ 




rrnake XZ positive 




smi. 


b 


fao) 




; remember sign 




bpl 


s 


pxz 








neg 


1 


XZ 






pxz 


tst 


1^ 


Y2 








bpl. 


s 


pyz 








not. 


b 


(aS) 








neg. 


1 


YZ 




;make YZ positive 



The following calculates X2K, which is XZ2 
See text for further exolanation 



;get upper word 



pyz 


move . 1 


XZ,X2K 




swap 


XZK 




move . w 


XZK, dO 




move , w 


dO,a2 




mulu.w 


XS,XZK 




swap 


XSK 


position 








rol.l 


#5, XZK 




andi . 1 


#S001fffff,X2K 


bits 








muls.w 


dO,dO 


XZ by itse 


If 






asl.l 


#4,d0 


position 








add.l 


dO,XZK 



/multiply with lower wcrd 
; shift it to the right 

;and double 

;ma3k off unneccessary 



/multiply upper word of 

; shift it to right 



The following calculates YEK, which is YZ2 works * 

the same as 

above. 



move . 1 


YZ,YZK 


swao 


Y2K 


move . w 


YZK,dO 


move . w 


dO, a3 


mulu.w 


YZ,YZK 


swap 


YZK 


rol.l 


#S,yzK 


andi.l 


#$001fffff,Y2K 
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muis.w 

asl.l 
add.l 



dO,dO 
#4,d0 
dO^YZK 



move.l XZK.dO 
add.l YZK,dO 
XZK+Y2K«XZ2+YZ2» (distance to originJ2 



cmpi.l #GRENSHI,dO 

bge.l klaar 

The following calculates 2'XZ*YZ and puts it in YZ 



;is the distance greater 

;than 2? 
;yes->f inish 



move.w a2,dO 
mulu.w YZ,dO 



;a2 is still upper word of XZ 
; multiply it by lower word of YZ 



swap dO 
rol.l #5,dO 
"these two instructions work like ror.l #11, dO would do. 

andi-1 #$C01ff ff f ,dO 



3$ 



move - w 
mulu.w 
swap 

rol.l 

andi.l 

add.l 

swap 
swap 
muis.w 

asl.l 
add.l 

tst .b 
beq.s 

neg- 1 



add.l 



a3,dl ;do it vice versa 

XZ,dl 

dl 

#5,dl 

ISCQlfffff,dl 

dl,dO ;add the two 



YZ 
XZ 
XZ,YZ 

#5,YZ 

dO,yz 

{a6) 
3S 

YZ 



;get upper word of XZ and YZ 
;multiply them 

;now YZ contains result 2*XZ*YZ 
;what was the sign again? 



,*we only have to negate this one, 
;as XZ2 and YZ2 are always 
/positive. 
yc-v(a6),YZ ;add Im c 



algolo: 



The new value of XZ is XZK-YZK+Re c 
rr.ove.l XZK, XZ 
sub.l YZK,XZ 
add.l xc-v(a6),XZ ;Re c 
addq.w II, d7 /increase Counter 
bra.l Ihi 

Low precision algorithm 
swap X2 
swap YZ 

The next is a preliminary check, necessary to 
avoid overflowing of XZ or YZ 
cmpi.w #WGRENS,XZ 



bge.s 

cmpi.w 

ble.s 


klaar 

#-WGR£NS,XZ 

klaar 


move . w 

muls .w 
swap 

rol.l 


XZ.XZK 

XZ,XZK 

XZK 

#16-PR,X2K 


^preliminary check 
CMPI.W 
BGE.S 
CMPI.W 
BLE , S 


#WGRENS,YZ 

klaar 

#-WGRENS,YZ 

klaar 


move.w 
muis.w 
swap 
rol.l 


yz,YZK 
YZ,YZK 
YZK 

tl6'PR,YZK 



?this is XZ2 



cmp.w d6,d7 



bge.s 



klaar 



move . w 
add.w 
cmpi . w 


XZK.dO 
Y2K,dO 
IGRENS^dO 


bge.s 


klaar 


YZ becomes XZ*Y2*2+Im c 

muis.w XZ,Y2 

swap YZ 

rol.l #16-PR+1,YZ 

add.w yc-via6),YZ 



/YZ2 

;have we reached the 

/maximum 
•number of iterations 

/already? 
/yes-finish 



;is the distance to the 

/origin>=2? 
/yes-finish 



XZ becomes XZ2-YZ2+Re c 
move.w XZK,XZ 




Volume 4 Number 10 

Progmmmlng A: Hducdllon 
Programming 

HISol^ CompUcr by Cole Calistra 
A BASIC compiler that has good features, is quidic, 
and well worth the pficcl 
JForth Professional by jAck Wochr 
It fills the rciquircmcnis of the professional 
Forth programmer, 
Better TrackMousc by Kobcft Katz 
A trut onc-hanclcd trackball mouse! 
SiraClty Review by MiRud Mulct 

Htnv wcjuld you hindlo Eioston, Massachtijciw right before a major nuclear meltdown?? 
SimOty Conference cdiied by Richard Rae. 
A OOfifcrcncc with Will VS'right and 
Brian Conrad of SimCity feme 
AlOOO Rejuvenator edited by Richard Rae 
A conference with Gregory Tihbs, 
APL Athc Amiga A Friendly Pair by Henry Lippen 
A look at the hidden language of APL 
Saving l6-color plaurcs In hlgh-rcsolutlon 
by I'aul Casiongua>' 
Pan 'lliiec of the Fractals scries. 
Voliuoc 4 Number 10 (continued) 
MulU- Forth by Lonnic Watson 
How to implement an interface to the ARP liabrary. 
More requesters In AmlgaBASlC by John Wicderhim 
Flushing lx;yond the limits of BASIC 
with system routines. 
Glatt'a Gadgets by Jeff Glatt 
Adding gadgeLi in A«embJy. 
TsheU Part U l3>- Rich TaJconburg 
A ntr^' Amiga program that will enhance 
the comniand line environment. 
Function Evaluator In C by Randy Hinch 
A routine that accepts nuihematica! functior^s as 
siring inpLt and then evaluates the function. 

Education Special 

Big Machine On Campus by Joel I^lagou 

Humboldt Stale University in 

Northern California goes Amiga. 

Cooimodore's Educatori . 

CBM u^es video to reach the dassroom 

Ty*plng Tutor . by Ntike'Chip' Morrison 

Save tlie crv* of Keycaps from capital letters, 

Reading, 'ritiog A resolution by Joe DiCara. 

llirce paint programs priitiarily designed for 

prc*5chool and elementary- grades. 

The Amiga In Higher Education by Tony Preston. 

Rutgers i;niversity,in New Jersey, rccogniites the special value of the Amiga, 

Nciv Products and Other Neat Stuff 

by Ehitabclh G. Fedoriiyn 

Populous, O.MNI-PIAY Basketball, and more! 

Snapshot by R Urad Andrews 

Help Rambo save Colonel Trauimcnt in Rambo III, or drive a Perrari in the Grand Prix, 

PD Serendipity 

by Mike Morrison Mike 

Fred l-ish disks '229 to *236, 

No Flshlngl by Graham Ktnsey 

Graham reviews PD programs from the local BBS, 

Bug Bytes 

by John Sicincr 

John keeps us up-to-date with the latest software bugs! 

Roomers by the Bandito. 

The Uandito lists his annoyances, while Commodore gets ready for Christmas. 

Video Schmjdeo by Barry Solomon 

AC'S Video Editor gives us 

helpful hints and tips in video. 

C Notes from the C Group 

by Stephen Kemp. A look at a search utility prc^^^m. 
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NEW 

& 

IMPROVED! 



You just have to check out 

EXTEND 



NEW 

& 

IMPROVEDr 



It is the ultimate programming 
utility for BASIC!!! 

EXTEND extends you 68 NEW and exciting commands! 

Offers you complete control of all those hard-to-program 
functions the Amiga offers like: 
r IFF picture support (both LOADING <& SAVING!) 
T- EFF sound loading/playing! 

r Complete gadget support, char, input, point Sc click, etc.! 
r Total sub-menu support (polling, mutual exclusion, etc.!) 
r Complete system/requester support! 
f Picture bitmap scrolling commands! 
r Plus much, much more... too many commands to list!! 



EXTEND is a sumdard Amiga library just like EXEC, DOS. GRAPHICS. c(c. 
In fact, with jusi one easy LIBRARY slalemeni in your program, you get access 
to ail libraries, not just EXTEND! Also, EXTEND ts HtC^ compatible with all 
BASIC compilers so you can create professional, marketable, programs I 



L^^^^ffij 



COD 



Only,.. 

$39.95! 

INCLUDES 
SHIPPING! 




Sunsmile 
oftware 

533 Fargo Avenue 

Buffalo, NY 14213 

(716) 885-5670 



circle 185 on Reader Service card. 

sub.w YZK.XZ 

add.w xc-v{a6),XZ 



addq,w fl,d7 

1 



?inceraent Counter 



klaar 



bra.s 

move . b 

lsr*b 

roxi.w 

Isr.b 

roxi.w 

Isr.b 

roxi.w 

Isr.b 

roxi.w 

isr.b 

roxi.w 

move , 1 

add.! 

subq.w 

bne. 1 

addq . 1 

subq.w 
bne.l 



_array-v(a6,d7.w) ^dO ;d7 contains index 
;look up color 



#l,dO 

PLSIZE*-2(aO) 

#l,dO 

PLSI2E*-! taO) 

#l,dO 

(aO) 

fl,dO 

PLSIZE*l{aO) 

#l,dO 

PLSIZE*2 (aO) 

xcd-v (a6) ,dO 

dO, xc-v(a6) 

#1, hcoum:16-v la6) 

h21us 

#2,a0 

#lrhcount-v(a6) 
hlus 



adda.w moduio-v(a6} ,aO 

move.l ycd-v(a6),d0 

add.l d0,yc-v(a6) 

subq.w #l,vcount-v<a5) 

bne.l vlus 

movent. 1 (a7) +,dl-d7/a0-a6 

tnoveq.l #0,dO 

rts 



; shift out a bit 

,' shift it in plane 



; shift out 5th bit 

ffor plane 4 

? increase X coordinate 



; increase display 

/memory pointer 



;end of line-add modulo 



;last line? 
; yes -quit 



algo 
vcount 
hcount 
hcount2 



section 
xdef 

dc.b 
dc.b 
dew 
dew 
dew 



MERGED, data 
f i , _col o rmap , _ar ray 
^ ;sign 

; which algorithm 
; vertical position 



hcountl6 dew 
modulo dew 
xc del 
xc2 del 



; value to add after each line 



yc 


del 


xcd 


del 


ycd 


del 


fi 


del 


fw 


dew 


fh 


dew 


iter 


dew 


sx 


del 


sy 


del 


sw 


del 


sh 


del 


colormao dew 




dew 




dew 




dew 


array 


deb 


2,3,4,5 


6,7, B, 




deb 




deb 




deb 




deb 




dc.b 




deb 




dc.b 




deb 




ds.b 




end 






;pisnepointer 

FWIDTH/2 

rHEIGHT/2 

ITER 





2«PRHI 

1«?RHI 

$000, $D33, $222, S333r 5444, S555, 5666, S777 
$S88, $999, $AAA, $BBB, SCCC, SDDD, SEEE, $TFT 
$098, $0A9, $OBA, $OCB, SODC, SOED, $OFE, $0FF 
$870, $880, $A90, $BA0, SCBO, SDCO, $EDO, $123 



23,23,25,23,23,23,23,23,23,23 
24,24,24,24,24,24,24,24,24,24 
25,25,25,25,25,25,25,25,25,25 
26,2 6,2 6,26,26,26,26,26,26,26 
27,27,27,27,27,27,27,27,27,27 
28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28 
29,29,29,29,29,29,2 9,2 9,29,29 
30, 30, 30, 30, 30, 30, 30, 30, 30, 30, 31 
156 ;for a total of 257 bytes- 



/*fractals,c 

Created by Hugo Lypoens in 19S9 
•/ 

linclude "exec/types. h" 
linclude "exec /memory. h" 
linclude "intuit ion/intuitionbase.h'' 
#include "^intuition/intuition. h" 
#include "proto/exeeh" 
linclude "prcto/graphics.h'' 
#include '"prcto/intuition.h" 
# include ''proto/dos.h" 



Frac-al (void) ; 

Palette (struct Screen *, struct Window 

DrawPalette {struct RastPort *, short}; 
Rect (struct RastPort 



void 

void 

*,USHORT *) ; 

void 

void 

*, short, short, short, short, short} ; 

void Mapping (struct Window *) ; 

void Iterations (struct Window *)# 

void stcu_d(char *, long, short ) ; 

/*lelib function to convert an unsigned integer to a 
decimal string*/ 
void movmem(char ",char *, short); 

/*lelib function to copy a memory block*/ 



♦define abs(K) 
fdefine min {x,y) 
♦define max(x,y} 



(((x)>-0)?tx) :-(x)J 
((x)<(y)?(x) : (y)) 
((x)>(y)?(x) : (y)) 



♦define 


WIDTH 


320 


♦define 


HEIGHT 


200 


♦define 


DEPTH 


5 


♦define 


NUMCOLORS 


(1«DEPTH) 


♦define 


PLSIZE 


(WIDTH- HEIGHT/ 8) 


fdefine 


MINW 


16 


Idefine 


MINH 


16 


#define 


ZOOMLEVELS 


20 


struct 


IntuitionBase *Intuition3ase; 


struct 


GfxBase 


*G f xBase ; 


struct 


DosLibrary 


*DOSBase; 


long 




SysBase; 



extern unsigned short colormap [ NUMCOLORS 1 ; 
extern UBYTE array[257j; 

/*Mapping of pixel index to pixel color.*/ 

static struct IntuiText mip24=l 0, 31, JAM1,14, 1, 0,"rull'\ ); 

static struct IntuiText mip23^( 0, 31, JAMl, 14, 1, 0, "Medium", }; 

static struct IntuiText rcip22=( 0, 31, JAMl, 14, 1, 0, "Small", }; 

static struct IntuiText mip21={ 0, 31, JAMl, 14, 1, 0, "Tiny", }; 

static struct Menultem pmi2[4}={ 



i 



HULL, 0, 27, 145, 9, ITEMTEXT I ITEMENABLED | HIGHCOKP I CHECKIT, 
OxFFr7, (APTR)&raip24,0,0,0,0 
}, 

1 
&pmi2 [0] , 0, 18, 145, 9, ITEMTEXT ! ITE^KrJABLED I HIGHCC^F | CHECKIT 1 CHECKED, 
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OxFFFB, (APTR)fimip23,0,0,0,0 



6pmi 2 1 1 j , , 9 , 1 4 5 , 9 , ITEMTEXT I ITEMENABLED ( H IGHCOMP ( 
CHECKIT, OxFFFD, (APTRJ &mip22, 0, 0, 0, 



6pmi2t2l ,0, 0, 145, 9, ITEIMTEXTI ITEMENABLED | HI GHCOMP | 
CHECKIT, OxFFFE, (APTR) &mip21, 0,0,0,0 



}; 



struct Menu m2^i 

NULL, 115, 0, 100, 0,MENUENABLED, "Screen Size", &pmi2 [3] 
}; 
static struct IntuiText mipl6»( 

0,31, JAMl, 8, 1, 0, "Quit", 
}; 
static struct Menultem pmil6=( 

NULL, 0, 54,145, 9, ITEMTEXT ( ITEMENABLED 1 HXGHCOMF, 

0, (APTR)&mipl6,0,0, 0,0 

static struct IntuiText mipl5=( 

0, 31, JAMl, 8,1,0, "Color Palette", 
)? 
static struct Menultem pmil5=i 

fipmil 6, 0,4 5, 14 5, 9, ITEMTEXT I ITEMENABLED fHIGHCOMP, 

0, (APTR) &mipl5, 0,0, 0,0 

static struct IntuiText mipl4 5*={ 

0,31,JAMl,8,l,0,"Color Mapping", 
}; 
static struct Menultem pmil45={ 

&pmil5, 0, 36, 145, 9, ITEMTEXT IITEMENABLED I HIGH COMP, 

0, (APTR) S:rdDl4 5, 0,0, 0,0 

J; 

static struct IntuiText mipl4={ 
0, 31, JAMI, 8, 1, 0, ''^Iterations", 

}; 

static struct Menultem pmil4=i 

fipmil45,0,27,145,9, I TEMTEXT I I TEMENABLED | HIGHCOMP , 
0, (APTR) &mipl4, 0, 0, 0, 

}; 

static struct IntuiText mipl3={ 

0, 31, JAMl, 8, 1, 0, "UnZoom", 
}; 
static struct Menultem pmil3={ 

&pmil4,0,18,145,9, I TEMTEXT I ITEMENABLED | HI GHCOMP , 

0, (APTR) &mipl3, 0,0, 0,0 
}; 
static struct IntuiText mipl2={ 

0, 31, JAMl, 8, 1,0, "Zoom", 
}; 
static struct Menultem pmil2=( 

&pmil3, 0, 9, 145, 9, ITEMTEXT | ITEMENABLED ! HXGHCOMP, 

0, (APTR)&mipl2, 0,0,0,0 

J; 

static struct IntuiText mipll^l 

0, 31, JAMl, 8, 1, 0, "Draw Fractal", 

}; 

static struct Menultem psiill«{ 

&pinil2,0,0,145,9,ITEMTEXT|ITEMENABLED|HIGHCOMP, 

0, (APTR) &mipll, 0,0, 0,0 
\t 

struct Menu ml={ 

&m2, 15, 0, 100, 0,MENUENABLED, "Task", fipmill 
}; 

struct NewWindow nw»{ 

0,0,WIDTH,HEIGHT,0,14,GADGETUP|MENUPICK|MOUSEMOVE| 
MOUSEBUTTONS, BORDERLESS I SMART_REFRESH | ACTIVATE, 
0,0,0,0,0, 
0, 0, 0, 0,CUSTOMSCREEN 

}; 

struct BitMap bm={ 
WIDTH/ 8, HEIGHT, 0, DEPTH, 

}; 

Struct NewScreen ns=l 

0,0, WIDTH, HE I GHT, DEPTH, 0,1 4,0, CUSTOMS CEEEN I CUSTOMBITMAP, 
0,"Fast Fractals by Hugo Lyppens 1989",0,&bm 

J; 

/•This structure holds information on the position and 

size of the fractal segment being watched by the user.*/ 
struct Pinfo { 

long SX,SY,SW,SH; 

J; 

/*This is a shared structure of the C and Assembly program. 



Instead of passing parameters via the stack, 
parameters are passed directly via common memory, which is 
more efficient and easier to program. 
*/ 

extern struct Fractallnfo { 

UBYTE * Planes,- /* Pointer to display memory*/ 

short FracWidth,FracHeight; /*?ixelwidth/height 

of picture" / 

USHORT Iter; /-Number of Iterations*/ 

struct PInfo P; 
} fi; 

/*Pixelwidths and heights associated with screen sizes*/ 
short fwidth[4]={ 

WIDTH/2,256/2,160/2,96/2 
K- 
shorr fheight[4i»i 

HEIGHT/2,128/2, 100/2,48/2 

); 

int mainO 

i 

struct Screen *s; 

struct Window *w; 

struct IntuiMessage *mes3age,* 

short code,x,y; 

ULONG class ; 

struct RastPort "rpO; 

UBYTE mm=0; 

short Ieft=-l,top=-l,height=0,width-0; 

short 2l-0,SE=0; 

register short i,j; 

register long 1; 

struct PInfo zoomstackfZOOMLEVELS] ; 

/*This array holds successive zooming operations 

It enables the user to UnZoom after doing Zoom, to go 
back. 

*/ 

SysBase=* (long *) 4L; 

/*Dirty initialisation to avoid startup-code*/ 

D0S3ase= (struct DosLibrary *) OpenLibrary f'dos. library", 0) ; 

GfxBase= (struct Gf xBase *S OpenLibrary ("^graphics .library", 0) ; 

IntuitionBase= (struct IntuitionBase 
*)OpenLibrary{**intuit ion, library", 0) ; 

if (! (fi,Planes=AllocMem{PLSIZE*DEPTH,MEMF_CHI?|r^!^_CLEAR) ) J 
goto weg; 
/*Allocate contiguous block for display memory*/ 
for(i=0;i<DEPTH,-i++J { 

bm. Planes fi:-fi. Planes+i*PLSIZE,' 
\ 

/*Set the plane pointers*/ 
if ( i (s=OpenScreen (ins) ) ) 

goto weg; 
LoadRGB 4 ( & s - >Vi ewPo rt , & colo rmap 1 ] , NUMCOLORS ) ; 
nw.Screen=s; 
if ( ! (w=OpenWindow (&nw) ) ) 

goto quit2; 
SetMenuStrip (w, Sml) ; 
rpO=w->RPort; 
dofrac; 
i=0; 

while ( ! (pmi2 [i] .Flacs&CHECKED} ) 
i+-i-; 

/*Find out which screen size was selected and put in i: 
0=Tiny, 
l=Small, 
2=Medium, 
3-Full. 
*/ 

if (i>S2) { 

SetRast (rpO, 0) ; 

for { j-0 ; j<NUMCOLORS ; j++ ) { 

SetDrMd(rpO, JAMl) ;SetAPen (rpO, j) ; 
RectFill (rpO, 16+ ( j«3) ,16, 16+7+ {j«3) , 16+7) ; 
} 

/*Draw color bar*/ 
} 

sz-i; 

fi,Frac*^idth=fwidth[i] ; f i.FracHeight=f height [i] ; 
Fractal ( ) ; 

/*Fractal() is the incredible Machine Language 
Fractal drawer see Assembly Listing*/ 
goto lus; 
lus2: 

WaitPort {w->UserPort) ; 

lus: 

if (Mmessage= (Struct IntuiMessage *) GetMsg (w->UserPortJ ) ) 

goto lus2; 
x=message->MouseX;y"me3sage->MouseY; 

code*message->Code;Glass'-message->Class; 
ReplyMsg( (struct Message *) message); 



Amazing Computing V4J1 ©1989 



87 



switch {class) i 
case MOUSEBUTTOKS! 
switch (code) ( 
case SELECTDOWN: 
/*Start a rubber box*/ 

SetDrMd(rpO, COMPLEMENT) ; 
if (left>=0) { 

EectUpO, left, top, width,height,l);/*erase existing 

box*/ 

left=x/top=yi-width=MlNW;mm=l/*Rubber box mode on*/; 
ReportMouse (w, 1) ; 
goto redr; 
case SELECTUP: 
/*End a rubber box*/ 
if (mm) { 

nini=0; ReportMouse (w, 0) ,* 



break; 



} 



break; 
case MOUSEMOVEi 
if (mm) { 

WaitTOFO; /*Avoid Flickering*/ 
Rect(rpO, left, top, width, height, 1); 
width=max ix-left+I,MINW) ; 
redr: height=width* f height [ss] /fwidth[sz3 ; 
Rect irpO, left, top, width, height, 1) ; 
/* Draw the rubber box*/ 
} 

break; 
case MENUPICK: 

if ( irwnSi ( i (MENUNUM (code) ) ) ) { 

/*Make sure that there's no rubber boxing going on now.*/ 
switch {ITEMNUM( code) ) { 
case 0:/*Draw Fractal*/ 

goto krot; 
case 3:/*Set Alterations*/ 

Iterations (w) ;break; 
case 4:/*Color Mapping*/ 

Mapping {w) ; break; 
case '2:/*UnZoom*/ 
if(zl){ 

f i.P= zooms tack[-zl] ;left=-l;goto dofrac; 

) 

break; 
case l:/*Zoom*/ 

if (zl<ZOOMLEVELSS&left>=0) { 
zooinstacktzl++}=fi-P; 

1=( (fi.P.SW»8)* {left+(width»l)-160) )/ 
fi.FracWidth; 

fi.P.SX+=l«8; 

l-( {fi.P.SH»8) * (top+ {height»l) -100) ) / 
fi.FracHeight; 

fi,P.SY+=l«8; 
1= I (fi.P.SW»8) *width) / 
fi.FracWidth;fi*P.SW=l<c7; 

1=( (fi.P.SH»8)*height)/ 
f i .EracKeight ; f i . P . SH=1«7; 
krot: 

left=-l;goto dofrac; 
1 

break; 
case 5: 

Palette is, w, &colormap[01 ) ;break; 
case 6: 

goto quit; 
1 



0, 0, JAl^l, {152-13*S) /2, 2, 0, "Color Mapping", NULL 
static struct Proplnfo pprop[3]={ 



break; 



} 



goto lus; 
quit; 

ClearHenuStrip (w) ; 

Closewindow(w) ; 
quit2: 

s->Flags=CUSTOMS CREEK; 

/*Funny thing: Disabling the CUSTOMBITMAP flag seems to be 
the only way to get Intuition to close this screen properly*/ 

CloseScreen(s) ; 
weg: 

CloseLibrary { (struct Library*) DOSBase) ; 

CloseLibrary ( (struct Library*) Gf xBase) ; 

CloseLibrary ( {struct Library*) intuitionBase) ; 

return (0) ; 
} 
static struct IntuiText treq5={ 

0,0,JAM1, (276-20*8) /2, 2,0, ''Define Color Palette", NULL 

); 

static struct IntuiText treq6=i 



{ 



FREEHORIZ, 0, 0, 0x1000,0x8000 1, 
FREEHORIZ,0, 0,0x1000,0x8000 ), 
FREEHORIZ, 0,0, 0x1000, 0x8000 } 



}; 



static short abortxy [] ={ 0, 0, 43, 0, 43, 10, 0, 10, 0, 0} ; 
static short okxy []={ 0, 0, IS, 0, 19, 10, 0, 10, 0, 0} ; 
struct Border borderabort={ 

0,0,0,0, JAMl, 5, iiabortxy[0] ,NULL 

}; 

struct Border borderok-( 

0,0,0,0, JAMl, 5, &okxy[0] ,NULL 

In- 
struct IntuiText tabort={ 

0,0, JAMl ,2,2,0, ''Abort" , NULL 

}; 

struct IntuiText tok={ 

0,0,JAM1,2,2, e'er', NULL 

struct Gadget gabortsp={ 
NULL,200, 84,44, 11, 

GADGHCOM? , ENDGADGET | RELVERIFY , REQGADGET | BOOLGADGET, 
(APTR) iborder abort, NULL, £t abort, 0, 0,1, 

K- 

struct Gadget goksp={ 

£gabortsp,248,84,20,ll, 

GAD GHCOI-IP, ENDGADGET | RELVERIFY, REQGADGET 1 BOOLGADGET, 
(APTR) 6borderok,NULL, &tok, 0, 0,2, 
}; 

struct Gadget gpal=( 
&goksp, B, 15, 32*8,16, 

GADGHNONE, GADGIMMSDIATE, REQGADGET I BOOLGADGET, NULL, NULL, 
NULL,0, 0, 6,0 

); 

SHORT knobdatal { ] -{ 

OxlEOO, /*000111100000*/ 

0x7F80, /*011111111000*/ 

OxElCO, /*111000011100*/ 

Ox7F80, /*011111111000*/ 

OxlEOO /*000111100000*/ 
); 
static struct Image knobl=t 

0,0,10,5,1, 

fiknobdatal[0] ,4,0,0 

static struct image knob2={ 
0,0,10,5,1, 
&knobdatal[0),4,0,0 

}; 

static struct Image knob3={ 

0,0,10,5,1, 

£knobdatal[0] ,4,0,0 
}; 
static struct Gadget gprop[l={ 



{ 



&gpal, 40,70,216, 10,/*Blauw*/ 

GADGHNONE i GADGII'lAGE, GADGIMI-IEDIATE I FOLLOWMOUSE, REQGADGET I 
PROPG,iU)GET, (APTR)£knobl, 
NULL,KULL,0, (APTR )&pprop to 1,3,0 



£gprop[0]/40,56,216,10,/*Groen-/ 

GADGHNONE I GADGIMa.GE, GADGII-IMSDIATE | FOLLOWMOUSE, REQGADGET l 
PROPGADGET, (APTR) Sknob2, 

NULL, NULL, 0, (APTR) &pprop[i] ,4,0 



Sgprop[l] ,40,42,216,10,/*Rood*/ 

GADGHNONE | GADGIMAGE, GADGII^iEDIATE | FOLLOWMOUSE , REQGADGET | 

PROPGADGET, (APTR) £knob3, 
NULL, NULL, 0, (APTR) &pprop [2] , 5, 
} 

static short 

reqspxy[) ={0,11, 0,0, 275, 0,275, 96, 0,96, 0,11, 275, 11); 
static struct Border reqspborder=| 
0,0,0,0, JAMl , 7 , &reqspxy f o'] , f^ULL 

static struct Requester cmreq={ 
MULL, 

(WIDTH-276)/2, (KElGHT-97) /2, 276, 97, 
0,0, 

&gprop[2: , 
&reqspborder, /*Req3order*/ 
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fitreqS, /"ReaTeKt*/ 

0,31 
)7 

static USHORT mask:[3|«(0xFF0>OxF0F,OxOFF}; 
void Palette (s, w, colormap) 
struct Screen *s; 
struct Window *w; 
USHORT * colormap; 
{ 

USHORT backupmap[32] , *ccolptr; 

ULONG idcmp, class; 

struct RastPort *rp; 

UWORD sd, selcol=0,xpos=8,ypos=15f 

struct IntuiMessage *message; 

register short j, curcomp, k, 1; 

short gid; 

ULONG Ing; 

idciTLp=w->IDCMPFlags 

movinem{ (char *) colormap, (char *) sbackupmap, 64) ; 

Modify IDQ-P ( w, GADGETUP 1 GADGETDOWN I MOUSEMOVE) ; 

cmreq.LeitEdge^{w->Hidth-27 6) »1; 

Cmreq.TopEdge= (w->Height-97) >>1; 

if i i (Request (&cmreq,w) ) ) 

goto weg; 
rp=cmreq.ReqLayer->rp; 
sd=l«s->Bit Map. Depth; 
DrawPalette (rp, sd) ; 
if (sd==64)3d=32; 
j=0;goto inspr; 
moos: 

WaitPort (w->UserPort) ; 
sam: 

if (1 {message={ struct intuiMessage •)GetMsg(w- 
>UserPortJ ) )goto moos; 

gid=( [struct Gadget *) (message-->IAddress) ) ->GadgetID; 

k=message->MouseX;l=Tnessage->KouseY; 

class=message->Class; 

ReplyMsg( (struct Message *}message); 

switch (class) ( 

case GADGETDOWN: 

if (gid>^3££gid<==5) ( 

curcomp=gid-3;goto adjust color; 
} 
j={k*-^8+cmreq.LeftEdge)>>3) + ( (1>= (23+cmreq.TopEdge) )«5) ; 
if (j>=sd) 
break; 
Rect (rp, xpos,ypos, 8,8,0); 
xpos=8+ { ( JS31)«3) ; 
ypos=15+((j»2)&8); 
selcol=j; 
inspr :ccolptr=&backupmap[selcol] ; 
Rect (rp, xpos, ypos, 8,8,31); 
SetAPen(rp, j) ; 

RectFill (rp, 8,42, 7+24, 42+37-1) ; 
for(j=C;j<3; j++) { 

lng=*ccolptr>>( j*4) ; 
Ing- ( (IngfiOxF) *OxOOOOFFFFL) /15; 
Modif yProp ( igprop [ j ] , w, & cmreq, FREEHORI Z , 
Ing, 0,0x1000, 0x8000) J 

break; 
case GADGETUP: 
if{gid==2){ 

movmem((char * ) Sbackupmap, (char *) colormap, 64) ; 

LoadRGB4 (£s->ViewPort, colormap, sd) ; 
goto weg; 
case MOUSEMOVE: 
adjustcolor: 

*ccolptr&=mask [curcorap] ; 
1 ng= ( ULONG )ppr op (curcomp] .HorizPot; 
lng={ (log* 15) /OxOOOOFFFFL) « (curcomp*4) ; 
*ccolptr I =lng; 
SetRGB4 {&s- 
>ViewPort,3elcol, (*ccolptr>>8) , (*ccolptr»4) &15, 
*ccolptr£l5) ; 
break; 
} 

goto sam; 
weg: 

ModifylDCMP (w, idcmp) ; 
return; 
J 

void DrawPalette (rpO, nc) 
register struct RastPort *rpO; 
short nc; 
{ 

register j,x,y; 
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Circle 104 on Reader Service card. 

rpO->A01Pen-0; rpO->Flags I =AREAOUTLINE; 

forij=0; j<nc; j++) ( 

SetAPen(rpO, j);k-( (j£31)«3)+8;y-( {j>-32)«3)+15; 
RectFill (rpO,x,y,x^7,y+7} ; 

} 

return; 
} 

void Rect {rp, left, top, width, height, color) 
register struct RastPort *rp; 
short left , top, width, height, color; 
f 

SetAPen (rp, color} ; 

Move (rp, left, top) ;Draw(rp, left-^width-1, top) ; 
Draw(rp,left+width-l, top+height-1) ;Draw (rp, left, toc-^height- 
1); 

Draw(rp, left, top) ; 

return; 
} 
struct Stringlnfo sinumtNUMCOLORS-i-l] = { 

{NULL,NULL,0,4,0,0,0,0,0,0,NULL,0,NULL}, 

{^\0 ",NULL,0,4, 0, 0, 0,0, 0, 0,NULL, 0,NULL) , 

{"\0 ",NULL, 0,4, 0,0, 0,0, 0,0, NULL, 0,mJLL}, 

{"\0 ",NULL, 0,4,0, 0, 0,0, 0, 0, NULL, 1, NULL} , 

i''\0 "^jNULL, 0,4, 0,0, 0,0, 0,0, NULL, 2, NULL}, 

I ^nO '\NULL, 0,4,0, 0, 0,0,0, 0, NULL, 3, NULL} , 

{"\0 ",NULL,0,4,0,0,0,0, 0,0, NULL, 4, NULL}, 

{"\0 ^\NULL, 0,4, 0,0, 0,0, 0,0, NULL, 5, NULL), 

i''\0 *\NULL, 0, 4, 0, 0, 0, 0, 0, 0, NULL, 6, NULL) , 

(''\0 '\NULL, 0,4, 0,0, 0,0, 0,0, NULL, 7, NULL), 

[^^\Q ", NULL, 0, 4, 0, 0, 0, 0, 0, 0, NULL, S, NULL) , 

{"\0 ", NULL, 0,4, 0,0, 0,0, 0,0, NULL, 9, NULL), 

( "\0 '\NULL, 0,4,0, 0, 0, 0, 0, 0, NULL, 10, NULL} , 

{'^\0 '\ NULL, 0,4, 0,0, 0,0, 0,0, NULL, 11, NULL}, 

{"\0 ",NULL, 0,4, 0,0, 0,0, 0,0, NULL, 12, NULL}, 

{"\0 *^, NULL, 0,4, 0,0, 0,0, 0,0, NULL, 12, NULL}, 

{"\0 *^,NULL, 0, 4,0, 0, 0, 0, 0, 0,HULL, 12, NULL} , 

{"^VO '",NULL, 0,4, 0, 0, 0,0, 0, 0,NULL, 13, NULL), 

{"\0 ", NULL, 0,4, 0,0, 0,0, 0,0, NULL, 14, NULL), 

("\0 ",NULL, 0, 4, 0, 0, 0,0,0, 0,NULL, 15, NULL) , 

("\0 ", NULL, 0, 4, 0, 0,0, 0,0,0, NULL, le, NULL), 

{"\0 ",NULL, 0, 4, 0, 0, 0, 0,0, 0,NULL, 17, NULL) , 

("\0 ",NULL, 0,4,0, 0,0, 0,0,0, NULL, 18, NULL), 
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{'"NO ", NULL, 0,4, 0,0, 0,0, 0,0, NULL, 19, NULL}, 

{^\0 ",NULL,0,4,0,0,0,0,0,G,KULL,29,NULL}, 

{"\0 ^,NX]:.L, 0,4, 0,0, 0,0, 0,0, NULL, 39, NULL}, 

{''\0 *\ NULL, 0,4,0, 0, 0,0, 0,0, NULL, 49, NULL}, 

(^nO ",NULL,0,4,0,0, 0,0,0,0, NULL, 59, NULL}, 

P\0 ", NULL, 0,4, 0,0, 0,0,0,0, NULL, 69, NULL}, 

(^'VO ", NULL, 0,4, 0,0, 0,0, 0,0, NULL, 80, NULL), 

{"\0 *\NULL, 0,4,0, 0, 0, 0, 0, 0,NULL, 90, NULL) , 

{"\0 ", NULL, 0,4, 0,0, 0,0, 0,0, NULL, 100, NULL}, 

{"\0 ^,NULL, 0,4,0, 0,0,0, 0,0, NULL, 101, NULL} 

Ir 

struct Gadget gokka=i 
NULL, 124,172,20, 11, 

GADGHCO.MP, ENDGADGET I RELVERIFY, REQGADGETI BOOLGADGET, 
{APTR) sborderolt, NULL, stole, 0,0,2,0 

)f 

struct Gadget gnum[NUMCOLORSI«( 

(&go)cIca, 44,20+0*9, 32, e,GADGHCCMP, 
LONGINT I STRINGRIGHT f RELVERIFY, STRGADGET, 
0,0,0,0, (APTR)&sinumfl+0} ,0), 
{fign\^[ 01,44,20+1 '9, 32, 8, GADGHCOMP, 
LONGINT) STRINGRIGHT j RELVERIFY, STRGADGET, 
0,0,0,0, (APTR}Ssinumfl+l],0}, 

{fignum[l],44,20+2*9, 32, 8, GADGHCQMP, LONGINT! STRINGRIGHT} 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) &sinuin[l + 2] , 0] , 
( fignujn [2] , 44, 20 + 3*9, 32, B, GADGHCOf^, LONGINT f STRINGRIGHT 1 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) SSlnum[ 1 + 3 ] , } , 
{£gnuni[3} , 44, 20+4*9, 32, 6, GADGHCOMP, LONGINT | STRINGRIGHT | 
RELVERIFY, STRGADGET, 0, 0, 0,0, (APTR) SsinuraEl+4 ] , } , 
( fignum [ 4 ] , 44 , 20+5*9 , 32 , B, GADGHCOMP , LONGINT I STRINGRIGHT | 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) £sinum[l+5} , } , 
{&gnumt5] , 44, 20+6*9, 32, 3, GADGHCOMP, LONGINT I STRINGRIGHT | 
RELVERIFY, STRGADGET, 0,0,0, 0, (APTR) &sxn\lin[l + 6} , ) , 
{ignujp.t 6 1, 44, 20 + 7* 9, 32, 3, GADGHCOMP, LONGINT I STRINGRIGHT J 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) 5sinuniri + 7] , ) , 
(Sgnumt 7], 4 4, 2 0+8* 9, 32, a, GADGHCOMP, LONGINT [STRINGRIGHT I 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) &s£nuin[i + 8) , 0} , 
{&gnujn[8} , 44, 20+9*9, 32, 3, GADGHCOMP, LONGINT 1 STRINGRIGHT! 
RELVERIFY,STRGADGET,0,0,0,0, (APTR) fisinum[ 1+9] ,0}, 
{&gnuni[ 9}, 44, 20+1 0*9, 32, 8, GADGHCOMP, LONGINT I STRINGRIGHT! 
RELVERIFY, STRGADGET, , , , 0, (APTR) &sinuiii[l + lO J ,0}, 
{&gnum[10] , 44, 20+11*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT ! 
RELVERIFY, STRGADGET, 0,0,0, 0, (APTR) &sinujn[ 1+11 ] ,0}, 
{ignumdl] , 44, 20+12*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT I 
RELVERIFY, STRGADGET, 0,0,0, 0, (APTR) Ssinum [ 1+12] ,0), 
(fignum[12] , 44, 20+13*9, 32, 8, GADGHCOMP, LONGINT | STRINGRIGHT ] 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) &sinumll+131 , 0) , 
{Sgnuin[ 13 1,44,20+14*9,32, 8, GADGHCOMP, LONGINT] STRINGRIGHT! 
RELVERIFY, STRGADGET, 0,0, 0,0, (APTR) Ssinum [ 1+14 ] ,0}, 
{&gnumfl4] ,44,20+15*9,32, 8, GADGHCOMP, LONGINT! STRINGRIGHT ! 
RELVERIFY, STRGADGET, 0,0, 0, 0, (APTR) &sinuin[ 1+15] , 0} , 
{ &gnum[15] , 110, 20+0*9, 32, 8 , GADGHCOMP , LONGINT ! STRINGRIGHT ! 
RELVERIFY, STRGADGET, 0,0, 0,0, (APTR) 5sinum[l + 16J , 0} , 
{fignum [16], 110, 20+1*9, 32, 8, GADGHCOt-lF, LONGINT! STRINGRIGHT! 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) &sinuin[l + l7] , 0} , 
i&gnmn[173 , 110, 20+2*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT 1 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) £sinuin[l + l8] ,0}, 
{£gnuin[18] , 110, 20+3*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT ! 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) fisinumCl+19] ,0), 
{&gnum[19] , 110, 20+4*9, 32, B, GADGHCOMP, LONGINT! STRINGRIGHT] 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) &sinum[l+203 ,0] , 
(&gnum [20], 110, 20+5* 9, 32, 8, GADGHCOMP, LONGINT 1 STRINGRIGHT 1 
RELVERIFY, STRGADGET, 0,0, 0,0, (APTR) &sinuin[ 1+21] ,0}, 
(fignum [21], 110, 2 0+6* 9, 32, a, GADGHCOMP, LONGINT! STRINGRIGHT I 
RELVERIFY, STRGADGET, 0,0, 0,0, (APTR) Ssinuin[ 1+22] ,0}, 
[&gnum[22] ,110, 20+7*9, 32, 8, GADGHCOMP, LONG INT! STRINGRIGHT ! 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) fisinum [ 1+23 ) , } , 
i&gnumt23] , 110, 20+8*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT ! 
RELVERIFY, STRGADGET, 0,0, 0,0, (APTR) &sinuin[l + 24 ] , 0} , 
{fignujnI241 , 110, 20+9*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT ! 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) fisinum[l+251 ,0}, 
{&gniiin[ 25], 11 0,2 + 1 0*9, 32, 8, GADGHCOMP, LONGINT I STRINGRIGHT! 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) &sinum[l+26] , 0} , 
{ignum [26], 110, 20+11* 9, 32, 8, GADGHCOMP, LONGINT! STRINGRIGHT! 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) &sinum[l + 27] ,0}, 
i&gnum[27] ,110, 20+12*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT I 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) &sinum[l+28] , ) , 
{fignum [28] ,110, 20+13*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT | 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) &sinuin[l+29} , 0} , 
{&gnum[29] ,110,20+14*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT I 
RELVERIFY, STRGADGET, 0, 0, 0, 0, (APTR) Ssinum[l+30] ,0) , 
(&gnum [30] , 110, 20+15*9, 32, 8, GADGHCOMP, LONGINT ! STRINGRIGHT I 
RELVERIFY, STRGADGET, 0,0,0,0, (APTR) &sinum[ 1+31 ] ,0} 



}; 

static sJiort 

kareqxy (]={ 0,11, 0,0, 161, 0,1 61, 184, 0,184, 0,11, 151, 11}; 

static struct Border kareqborder={ 

0,0, 0,0,JAMl,7,£Jcareqxy [0] ,NULL 
}; 
static struct Requester ]tareq=i 

NULL, 

(WIDTH-152} /2, (HEIGHT-185) /2, 152, 185, 

0,0, 

&gnum[31] , 

slcareqborder, /*ReqBorder*/ 

Streq6, /*ReqText*/ 

0,31 
]; 

void Mapping (w) 
struct Window *w; 
( 

register i,x; 

register struct RastPort *rp,* 

f or ( i«l ; KNUMCOLORS + 1 ; i ++ ) 

stcu_d(sinum[i] .Buffer, sinum[il .LongInt, 4) ; 
Request (fi!careq,w) ; 
rp=)careq.ReqLayer->rp; 
rp->Flags ! =AREAOUTLINE; 
rp->AOlFen=0; 
x=20; 

for (1=^0 /KNUMCOLORS ;i++) { 
if (i&16)x-96; 

SetAPen(rp,i) ;RectFill {rp,x,20+9* (i£l5) ,x+9,27+9* (i£l5) ) ; 
} 

WaitPort(w->UserPort) ; 
x=0; 

for{i«0; KNUMCOLORS ;i++) ( 

sinum[i+l] .LongInt=inax(sinumri+l] .LongInt, sinuin[i] .LongInt) ; 
sinuni[i+l) . LongInt =niin(3inuin[i+l ] .LongInt, fi-Iter+1) ; 
while (x<sinuni[i+lj .LongInt) ( 

array [x++]=i; 
) 
J 

return; 
] 

static short 

req3xy[} = { 0,11, 0,0, 133, 0,133, 129, 0,129, 0,11, 133, 11); 
Static struct Border 
req3border={0, 0,0,0, JAMl, 7, £req3xy [0] , NULL ]; 

static struct Stringlnfo 

siiter-CnOOVO", NULL, 0,4,0, 0, 0, 0, 0, 0, NULL, 100, NULL 1 ; 

static struct Gadget giter«{NULL, (134-32) 2,20, 32, 8, GADGHCOMP, 
LONGINT ! STRINGRIGHT [ SNDGADGET ) RELVERIFY, 
REQGADGET t STRGADGET, 0, 0, 0, 0, (APTR) Ssiiter, 2S2, } ; 

static struct IntuiText treq3iter»( 

0,0,JA.M1, (134-15*8) /2, 2,0, "Set #Iterations", NULL }; 

struct Requester iterreq={ 

NULL 70,50,134,54,0,0,£giter, 

fireqSborder, /*ReqBorder*/ 

&treq3iter, /*ReqText*/ 

0,14 }; 
void Iterations (w) 
struct Window *w; 
{ 

register ULONG i; 

register USHORT j,x,- 

stcu_d(siiter.Buffer,siiter. LongInt, 4) ; 

Request (fiiterreq, w) ,- 

WaitPort (w->UserPort) ,* 

siiter.Longlnt=max (siiter. LongInt, 1 ) ; 

siiter, LongInt **min (siiter . LongInt, 256) ; 

l=siii:er.LongInt; 

x=0; 

for(j=l; j<NUMCOLORS+l; j++) { 

if (sinum[j] .LongInt==f i .Iter) 
sinum[j] .LongInt=i; 

else 

sinum[ j] .LongInt =3inum[j] .LongInt* (i+1) / {fi.lter+1} ; 

while (x<sinum[j] .LongInt) 
array [x++]=j-l; 
}; 

fi.lter=i; 
return; 
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Notes 



KMfH tko C (ff^oap 



by Stephen Kemp 



After programming in C for a while, you will begin to realize 
the increasing dependency for functions and modules that were 
written for other programs. It is not difficult to frnd yourself in a 
position where you say, "I need something almost like that function 
I wrote for that last program, " The function gets copied into die new 
program with a few changes and voila! 

In many instances, these functions can be used without 
modification. In fact, these are probably functions that you use over 
and over from program to program. Once you have acquired 
"stable" functions that can be used in any program, it may be time 
to begin developing your own librar)^ of these routines. 

Past discussions and listings have made assumptions about 
the use of libraries. All C compilers come witii at least one library 
of routines (usually referred to as the "standard" librar>0. Some 
compilers will also have additional libraries with specialized 
functions for math or graphics. Unfortunately, no library will have 
all the functions diat you will want to use. Furthermore, as I have 
mentioned in the past, standard C libraries are not very standard. 
Some will have dozens more functions than others. 

Creating personal libraries is easy but requires careful consid- 
eration. Not every function "deserves" to be included into a librarj^ 
For the most part, a library* function should be self-sufficient. This 
means that everything tlie function requires is included in the 
function. If the function references other functions, tliey too should 
be library functions. It is not usually a good idea to make a function 
that requires your remembering to include some specific code in 
die program. Sooner or later, you may forget what to do, or 
someone else will inherit the problem. 

Next, a potential library function should make as few 
assumptions about its parameters as possible. For instance, prob- 
lems can arise if die function assumes that a parameter is a 10-byte 
string. What happens if it's longer? Shorter? What if it receives a 
NULL pointer? Naturally, some assumptions have to be made; just 
try to consider whether they are reasonable. Resist the temptation 
of saying, "I'll remember", because one day it will come back to 
haunt you. 

Finally, document your functions. Write down descriptions, 
as well as their syntax, parameter types, return value types, etc. 
Even the most experienced C programmers occasionally have to get 
out their manuals to refresh their memory. Be sure to keep a hard 
copy of the listings also. If somediing should happen to your disk, 
at least there is something to fall back on. Additionally, if you find 



yourself trying to remember tlie specifics about a flmction in your 
library, you can pull out a listing without having to sort through 
your diskettes looking for the source. 

In a past listing, 1 included diese functions because diey were 
not available in my Manx C library. As the descriptions read, these 
funaions can be used to change a string to upper or lower case. Use 
these to test your hand at creating your own library. 

/* strupr is a eunction that indexes through a string and converts 

*/ 

/* all alphabetic characters to upper case ^/ 

strupr ( str ) 

char *str; 

{ 

for ( ,-*str != '\0'; str++J /* search until null is found */ 
*str = toupper(*str) ; /* call upper case function */ 



/* strlwr is a function that indexes through a string and converts 

*/ 

/* all alphabetic characters to lower case */ 

strlwr ( str ) 

char *str; 



{ 



for ( ;*str != '\0'; str++) /* search until null if found */ 
*str = tolower (*str) ; /* call lower case function */ 



But before we try to include these new functions, a few remarks 
should be made about how libraries work, 

A library is a collection of compOed modules, not functions. 
This is an important point to remember. Referencing any one of 
several functions that a module contains will include all the 
functions that are found within it. This can make programs larger 
by including functions that are not necessary. For this reason, it is 
better to make one funcdon per module. Sometimes, several 
functions have "intertwined'' relationships (refer to each other). In 
diis event, keeping them together in a single module may make for 
easier maintenance. 

It is not necessary for a library module's name to have any re- 
lationship to tlie function(s) that it contains. For instance, the 
function strupr shown above could be in a module named "blarg" 
if desired. However, for the sake of clarity, it is wise to have some 
rhyme and reason in naming conventions. With only a few 
modules, using the function names may be simple and useful. 
However, once several dozen or hundred functions have been 
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accumulated, it may be easier to devise some numbering scheme 
to aid in the programming task. Numbering schemes usually 
involve setting ranges for certain tasks like: MYIOO to MY200 for 
string iiinctions; ivH^OO to MY400 for memory functions; etc. The 
point here is that a method that makes die most sense to tlie 
individual should be used in naming librar>' modules. 

Next, depjending on die linker used, tlie order that modules 
occur in a librar)^ can be very important. For instance, the Manx 
linker only makes 1 pass through a librai^^ This means that it is 
possible to receive an unresolved (or undefmed) symbol error 
when it is^ in fact, defined in the library. This can happen if one 
library function references another that "physically" exists in a 
module that occurs earlier in the library. 

To help explain iliis potential problem, assume that a library 
(my. lib) has only r^^o modules, named "fiinc_a" and "func_b", and 
that they are stored in diat order. Now suppose a program (prog) 
was written that uses tliis library, the link statement would look 
something like this: 

In prog -imy 

Keeping with the assumptions, suppose the program only refer- 
ences fLinc_b direcdy. If the function in tliis module were to 
reference something in the module func_a, the link step w^ill fail. 
The link fails because the first module will already have been 
passed widiout including it into the program. After finding the 
reference in the second module, the linker does not back up and 
start at die beginning of die library' again. 

There are xv^'o solutions lo this dilemma: 1) Reorder the 
library, or 2) include the library twice (In prog -Imy -Iniy) on the link 
statement. When possible, it is best to tiy the first solution. 

Libraries are created and maintained by "librarian" programs. 
Most of the C environments that I have encountered have included 
one of tliese programs, especially if a linker is also included. The 
MANX librarian is named "LB" but otliers are usually named 'vLIB". 
These programs are much like linkers. The user provides die 
module names on the command line (or in a command fOe) and has 
a variety of "switches'' to aid in controlling how and where the 
modules are placed in the library, I would not recommend 
modifying the libraries diat accompany C compilers. Experience 
has tauglit me that it is better to keep personal stuff separate 
because it is much more likely to be unstable (for a while). 

Tne two functions included above, stnipr and strlwr, should 
be placed into individual files. Name diese files the same as tlie 
funcdons. Once they have been compiled successfully, it is time to 
place them into a librar^^ Since I have the M>VNX environment, the 
examples will be drawn from diat. Other librarians will work 
similarly, probably using different command switches. Be sure to 
have the manual handy and make translations where required. 

There are many commands that can be used with the librarian 
program. Some are more advanced than we have time to cover 
here. The commands for LB diat will be focused upon are: 

-a ADD module after the indicated module 

-b ADD module before the indicated module 

-r REPLACE module in the library 

-d DELETE module from die library 

-t LIST die modules in the library 

The first two switches can be used to prevent the "order" 
problem that w^as discussed eariier. The diird, -r, is important for 



replacing old modules with new updated modules. Removing a 
module from tlie library can be accomplished using the delete 
option. Finally, a complete list of the module names that are 
included in a library can be obtained using the last switch. 

Before discussing these switches, this is how a library can be 
created using diese two functions. 

LB ray lib strupr strlwr 

This command line will cause the librarian to create a library named 
*'M\TIB". This library' will include two modules, "strupr" and 
'^strlwr", in the order that they arc specified. Once a libraiy has been 
established, it can be used for linking programs. For a program diat 
uses such a function, the link step might look somediing like tliis : 

LN prog -Imylib -Ic 

Notice that the library was included before the standard library in 
the link step. This will be important if die function's reference items 
found the standard librar>^ (w^hicli, in many instances, will be the 
case). Remember, the linker only passes tlirough each librar>^ 
once — resolving symbols as it goes. If a fimction references another 
module that has been passed over, an error will be generated by 
the linker. 

Refer back to the order problem presented earlier. Naturally, 
the library could be deleted and created again in a specific order, 
if a problem should occur. Howx'ver, tliis is not die best solution for 
a well-established librar\^ Fortunately, at least two commands are 
available to keep diis from taking place. The first is die -a command. 
It can be used like this: 

LB my -a func_b func_a 

This command line tells the librarian to include the module 
'*func_a" after the module named '*fLmc_b". Likewise, if it was 
important to include the module in front of the odier, diis command 
line could be used. 

LB ray -b func_b func_a 

If a module is already a part of the libraiy, then it could be replaced 
using the -r command. It is important to replace modules rather than 
add them again. If the old module is not removed, dien the link step 
will include the module that occurs earliest in die library (once it 
has been reference). The best policy is to replace modules or use 
die -d (delete) switch to remove the old one first. 

Finally, just to ensure dial the libraiy has been updated 
properly, use the -t switch to print die names of all the modules tliat 
are stored in the library. This list will be generated in the order that 
die modules occur in the library. Note: Some library^ programs will 
also print some of its own "overhead" names, but these can be 
ignored. 

Maintaining and using your own librarv^ is one of the things 
that you will probably enjoy about programming in C. After you 
have spent die time writing and testing functions tliat you find 
useful, diis is an easy method to use to make ilieni available for all 
your programming tasks. Try a few experiments with the switches 
that your librarian supports until you are satisfied diat you 
understand diem. Remember, you can always check die results by 
using the -t (in Manx's LB) to list the modules. 
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Multitasking in Fortran 



Working around the difficulties of Fortran on the Amiga 



by Jim Locker 

If you are like me and use your Amiga 
as a scientific workstation, you have proba- 
bly become familiar witli AbSoft Fortran for 
the Amiga. This Fortran compiler provides 
a full ANSI standard implementation of 
Fortran 77. 1 have ported many megabytes 
of software from various mainframes and 
other micros^ and have had very little 
difficult)^ making them run. The compiler is 
fast, the object code appears to be quite 
efficient, and there are no serious portabil- 
ity issues. There are a few ver^^ minor bugs 
in the compiler system, but generally, tlie 
package is quite solid. 

Howevetj AbSoft employs a rather 
primitive system interface which is not fully 
compatible witli the standard Amiga sys- 
tem interface. You cannot link it widi Alink 
or Blink, you cannot start it from Work- 
bench, and you cannot readily mix Fortran 
modules witli C or assembler modules — 
unless the mixing is done under tlie control 
of a Fortran program. It is possible to access 
most of the ROM Kernel routines using die 
Amiga. sub "glue" routine, which is pro- 
vided as part of die AbSoft package, but the 
overhead of this approach is extremely 
high, and there are some odier problems 
(which I w^ill discuss later). Also, you must 
build tlie system structures in code your- 
self. 

The include files provided by AbSoft 
represent an incomplete subset of the sys- 
tem stmctures, and only represent one 
copy of each stnictLire. You must declare 
and define any additional copies needed, 
as well as any stmctures not already de- 
clared. AbSoft Fortran supports recursion 
as a compiler extension (Amiga DOS and 
the 68000 make it eas\0. Therefore, you 
may recursively declare multiple copies of 
needed structures. However, diis is not 
standard Fortran and may lead to relatively 
difficult program development and debug- 
ging, especially if you desire a complex 
Intuition interface. 

The AbSoft compiler system was 
obviously intended by AbSoft to be easily 



portable between 68000 series computers. 
Although this specialized compatibilit>' 
causes problems when you try to interface 
fully to tlie Amiga operating environment, 
there is an unexpected side effect that can 
be beneficial in certain application envi- 
ronments. Specifically, the AbSoft compiler 
for Amiga can be used as a cross-compiler 
for any 68000 series computer. All you 
need to do is write a stari-up code module 
(in assembler) that is appropriate for the 
intended target machine, and then force 
the compiler to use that module at compOe 
time. 

Recently, I have been working on a 
complex application, building from a 
public domain Fortran package. Given the 
complexities of Intuition and tlie extensive- 
ness of my proposed interface, I wanted to 
build the user interface in C witli the aid of 
Power Window^s by Irmovatronics. This 
made it necessarj^ either to (1) translate 
over a meg of Fortran source to C, then 
debug and validate it, or (2) define a way 
to conveniently and comfortably interface 
AbSoft Fortran with Lattice C while retain- 
ing as much standard Fortran as possible. 
Because I did not want to spend die next 
few years validating complex mathematical 
algorithms, I chose the second route. 

This article discusses the approaches 
to interfacing Fortran and C which I inves- 
tigated, along witli my results, conclusions, 
source code, and recommendations. As a 
necessary^ adjunct to diis work, I built a 
Fortran start-up module that replaces the 
AbS oft-provided Init.sc and provides full 
Workbench support. I also built a Work- 
bench close-do^Ti module which must be 
linked into a Fortran program just aliead of 
the END statement, as w^ell as a module 
which can open or change die standard 
Fortran console I/O window. All these 
modules are in assembler. 

Using the Fortran linker F77L, you 
can link a module \\Titten in C (or assem- 
bler) to a Fortran program. It is not pos- 
sible, however, to link a Fortran module to 



a C module using Alink, Blink, or F77L. The 
AbSoft compiler can generate an assembler 
output instead of object code. In principle, 
you should be able to assemble this output 
using a native assembler, then link it using 
a native linker But in practice, tlie AbSoft 
compiler generates assembler code that is 
incompatible witli die Amiga assemblers 
Lhat I tried. While the Metacomco assem- 
bler does not permit arithmetic operations 
that use labels in an operand field, the 
AbSoft compiler actually prefers to gener- 
ate code that way. The Lattice assembler 
desires Hunk information that the AbSoft 
compiler does not provide. 

I don't own any odier assemblers, so 
I did not try any others. AbSoft states that 
their assembler output is in ftill compliance 
witli die Motorola standard and diat the 
incompatibility is due to the native .\miga 
assembler's nonconformance with that 
standard. While this statement appears to 
be true, it does litde to solve a major 
problem: literally thousands of patches are 
required to compile and then assemble a 
large Fortran source program this way. 

However, you are able to permit a 
Fortran module to communicate widi a C 
module by using the facilities of Amiga- 
DOS. To do tliis with maximum flexibilit)", 
you must give Fortran tlie capability to 
interface w^itli the operating system as a 
separate Amiga process with its ow'o envi- 
ronment. Then you can have separately 
compiled and linked Fortran and C mod- 
ules. It would be possible for the C modules 
to start first, kick off Fortran modules as 
required, communicate w^idi tliem, control 
diem (or be controlled by them), and tlien 
shut them down. 

It happens that there is a program in 
tlie Amiga S)^steni called Workbench w' hich 
routinely kicks off these types of processes. 
If the Fortran module can start and shut 
down under Workbench, then all otiier 
goals can be met. 

I used AbSoft Fortran version 2.3, 
Lattice C version 5.02, and Metacomco 
assembler version 10.178 throughout this 
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project. It is likely that the start-up routine, 
WBInit.asm, will be slightly different if you 
are using a different version of Fortran, 
tJiough I did not attempt to investigate that 
possibility, Tlie discussion cliat follows 
assumes you have some knowledge of tlie 
workings of the DOS librar>^ and the Exec 
library, as well as some familiarity with 
multitasking concepts. If you do not under- 
stand tliese references, I refer you to the 
literature, starting with the ROM Kernel 
Manuals. 

The Fortran system conventions 

The Fortran compiler is intended to 
be ponable among 68000 machines. Con- 
sequently, the compiler provides a simple, 
generic operating environment. At compile 
time, the compiler converts the source 
code to object code and installs a hard- 
coded header. The compiler then locates 
the start-up module, init.sc, and places it in 
the object module after tJie hard-coded 
header and before tlie compiled user code, 
Init.sc is the only machine- dependent 
portion of the compiler enviromncnt. All 
offsets are determined by tlie compiler and 
hard-coded into Uie object module. There- 
fore, tlie object module is one AmigaDOS 
Hunk and must reside in contiguous 
memory'. The use of ovedays modifies this 
requirement and permits multiple hunks, 
but at an extreme performance |:>enalty. 
Overlay handling may be machinu-dc' 
pendent, due to the implementation of tlie 
search patli. 

All Fortran functions are handled by 
die compiler as references to functions in 
the ain-time library, and are resolved by 
the compiler as hard-coded offsets from tlie 
base of the run-time library, which is main- 
tained in A3. Any calls to external functions 
lliat are not present in tlie source file^ — and 
are not part of the ain-time library — are 
maintained as externals. When an external 
routine is called at am time, a routine in die 
run-time library will search tiie current 
directory (the directory of the CLI which 
started the Fortran application) for the 
missing routine and will load and am it. If 
it is not found J tlie Fortran program will 
terminate witli an error message. 

Thus, it is not generally necessary to 
link all your Fortran routines into one 
executable T\\^. In fact, given that any 
routines so linked become j^art of tlie one 
and only main code hunk, it might not be 
desirable to link all externals together, 
since this requires a larger contiguous 
memory region to am tlie program. It is 
only necessary to ensure that any subrou- 



tines be located in the same direaory as the 

main program and be suffixed with the 
name .sub (as in "myfiincsub"). 

If die F77L linker is used, it merges 
the specified subroutines into the main file 
and replaces the segment of code which 
calls tlie run- time library external routine 
handler with a hard-coded offset andJSR to 
the newly linked subroutine. In fact, as we 
shall find, the F77L linker loves to niodif)' 
code in the object file. It links using the 
subroutine name only. There are no vari- 
ables in a subroutine which are globally 
available, except for die names of Common 
blocks (this, of course, is standard Forti'an). 
No external tags are resolved by the linker. 
F77L will refuse to link a subroutine written 
in C or Assembler, unless tliat subroutine 
has been fully linked using Alink or Blink. 
Thus, you cannot provide links between 
Foruan and C by using F77L to link a C 



Frankly, for 
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object module to Fortran, and then using 
Blink to resolve the C links. 

The init.sc start-up module provided 
by AbSoft assumes tlie program has started 
from die CLI, and it shares the CLI environ- 
ment completely. The Fortran compiler 
provides the first six instructions of the 
start-up code, loading a couple of hard- 
coded offsets into registers Al and A2, then 
loading die size of die program data area 
into Dl, and an identifier for which run- 
dine library to use into D2, After issuing 
diese insDxictions, the init,sc module be- 
gins. It saves registers representing the 
number of command line arguments and 
die location of diese arguments. Using a 
hard-coded value from the compiler, it 
allocates memory for die required data 
areas. If the mn-time library is not linked 
into the program, memory is allocated for 
it also (again a hard-coded value). The 
module then loads the DOS library and 



finds the CLI file handles to use as the 
standard console. If the run-time library^ is 
not linked, init.sc fmds it by searching in 
die current directory, then in the nearest L 
directory and, finally, in the Sys:L directory. 
It then jumps into die run-time library using 
an offset from A5. 

The F77L linker determines whether 
the F77.rl library* is linked in. F77L modifies 
code in the init.sc module when it links the 
run-time library. Specifically, those refer- 
ences to memory allocation for the ain- 
time library are modified to yield no opera- 
tion. Then, the fii'st three instructions of the 
segment of code which locates and loads 
die ain-time libraiy are modified. The 
modified code uses a linker-determined 
hard-code offset from die beginning of the 
program to load the absolute address of the 
run-time library into A5, dien jumps to diat 
location and continues execution. The 
remainder of the start-up code, which 
would search for and load die run-time 
library, is still present in the linked code, 
but is bypassed and ne\^er accessed. 

When the linker makes diese modifi- 
cations to the code, it apparendy counts a 
certain number of bytes and then changes 
die insuuction diat is stored there, wiUiout 
checking to make sure that die insDucUon 
it changes is die one it wants to change. 
Thus, the size and organization of tlie start- 
up module provided by AbSoft is evidently 
hard-coded in die linker. This lack of so- 
phistication introduces complications for 
anyone who wishes to modif>^ die stan-up 
code. In fact, diis is why my start-up code, 
WBInit.asm, has three sections of imbed- 
ded NOP instructions surrounded by labels 
and jumps. 

The Amiga, sub routine provides 
hooks into the Amiga operating environ- 
ment, making it possible to access ROM 
Kernel routines. The mechanism employed 
is veiy time-consuming, aldiough it is 
space-efficient if you ha\^e a large numbt;r 
of calls to the ROM Kernel. 

Fortran comes with a set of Include 
files located in die Interface director)' on 
die distribution disk. Each of these Include 
files contains, among other tilings, a listing 
of the applicable ROM Kernel routines 
which are identified as 32-bit hex numbers 
using a parameter statement. 

When the user does a CALL 
AMlGA(ROM rati tine, argl, a?'g2... at-gn), 
the hex number is passed to Amiga, sub in 
die ROMroutine field. This hex number is 
encrypted w^ith information concerning the 
library base offset of the desired ROM 
routine, its library, and information about 
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all its arguments. Amiga, sub decodes this 
number (in several hundred clock cycles), 
checks to see if tlie relevant library is open 
(and opens it if it is not), and then calls the 
appropriate routine. 

Unfortunately J some of the hex 
numbers provided by AbSoft are incorrect, 
PutMsg and FreeiMem are incorrect, since 
botli of tliese bit me over the course of the 
project. Essentially, Amiga. sub winds up 
passing pointers to the pointers required by 
these ROM Kernel routines, instead of 
passing die pointers themselves. This prob- 
lem with FreeMem motivated the assem- 
bler module FREMEM,ASM, which is listed 
here. 

I should add, however, that I have 
used many of die Intuition and Graphics 
librar>^ routines dirough Amiga, sub widiout 
encountering this problem. It is possible 
that the wrong numbers only exist in the 
less commonly used Exec and DOS rou- 
tines. I could have fixed these specific 
examples, but I concluded that I could 
buUd the assembler routines in far less time 
than it would have taken me to decipher 
the hex codes. Besides, the dedicated as- 
sembler routines have much higher per- 
formance. 

The Workbench environment 

This subject has been described ex- 
tensively in a variety of locations, so I will 
not dwell on it here, except to describe 
briefly the flow of events that must be 
considered. 

When Workbench starts a program^ it 
constructs a message called a Workbench 
Start-up message. This message contains a 
number of parameters which are of pos- 
sible interest to a new process^ including 
the current director^^ and possibly a de- 
scription of a default console, Workbencli 
then calls the Exec routine LoadSegO to 
load the program code, and the Exec rou- 
tine CreateProcO to create the new process 
and start it running. Arguments to 
CreateProcO include process priority and 
process stack size. Workbench then sends 
a pointer to the Start-up message to the new 
process, telling it what it needs in order to 
execute correcdy. Workbench will unload 
the new process and clean up when the 
new process replies to the Workbench 
Start-up message. 

To exist peacefully in this environ- 
ment, a new process must first do a 
FindTaskCO) in order to find the locations of 
its own Process Control Block and Mes- 
sagePort in the system. Then, it must wait 
at its message port for the start-up message 



from Workbench. When die message ar- 
rives, the process must store die pointer to 
the Workbench message, use whatever 
information in the Start-up message is of 
interest to it in whatever fashion is appro- 
priate, and then go about its normal busi- 
ness. 

Wlien the process is ready to exit, it 
must return die Start-up message to Work- 
bench usinga ReplyMsgO. This is tlie signal 
for Workbench to unload die code for die 
process and to free all resources. Before 
doing the ReplyMsgO, the process must 
execute a ForbidO in order to disable 
multitasking while it terminates itself. 
Otherwise, Workbench might unload the 
process before it has officially terminated. 
After doing die ReplyMsgO, die process 
must immediately enter its exit handler to 
tell DOS it wants to be unloaded. 



Thei^e is a bug 
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Integ^athigFortranimdWorkbench 

My start-up code handles all die 
requirements of Workbench or CLI start- 
up, including an optional default window, 
(Yes, it is now possible to mn a Fortran 
program widi no window attached. Widi- 
out one, of course, no error messages will 
be reported.) The code handles the start-up 
in a fashion which is totally transparent to 
die applicadon — no modifications to For- 
tran source code are required to support 
the start from Workbench. Workbench 
shutdown is accommodated by a call to 
WBend, which must be the last statement 
before the END statement in a main pro- 
gram. This call to WBend is needed to do 
the ForbidO and ReplyMsgO calls. These 
functions should be handled in die END 
statement, but that would require changes 
to the mn-time library. 

The WBend.su b routine must be 
linked into the Fortran program using F77L, 



even if nothing else in the program is 
linked. This is because I did not preserve 
register AO in this routine. The Fortran 
user's guide indicates that routines used as 
ovedays must preserve AO. I chose not to 
save AO in order to force WBEnd to be 
linked. For my project, die Fortran program 
wOl not be started from Workbench. If die 
C program that launches die Fortran pro- 
gram does not pass information on the 
current directory to die Foitran program in 
the Start-up message (and I do not intend 
to pass that information), then WBEnd will 
never be located by the program if it is run 
unlinked. Nevertheless, it is simple enough 
to preserve AO if you choose to do so. 

The ROM Kernel manual discussion 
of die Workbench environment indicates 
that information about a default window, to 
be opened by the application, may be 
contained in the application's icon. The 
start-up message sent by Workbench will 
pass the window information to die appli- 
cation. The C start-up code provided wi± 
Lattice C assumes this is tnie and either 
does or does not open a window, depend- 
ing on the contents of the Start-up message. 
For conipatibilir)% WBInit.asm also checks 
die start-up message for this information. 

There is a bug in Workbench which 
was documented in an early release and 
was apparendy never fixed. Contrary to its 
documented capabilities, Workbench does 
not pass the information about the default 
window to the application. This is not a 
significant problem for my intended appli- 
cation, I intend to launch Fortran routines 
in die background. Therefore, I do not 
really care if die Workbench works as ad- 
vertised, since I will pass the informadon I 
want to the Fortran routine at start time. It 
will not matter if Workbench does not tell 
the new process about the window, be- 
cause my application will do diat. 

However, from the standpoint of a 
true Workbencli start-up, this is a signifi- 
cant problem. I had already done most of 
the work required to enable Fortran to start 
from Workbench, so it seemed logical to 
finish die job. Given that the Fortran com- 
piler insists that die start-up module be 
named Init.sc, I was not willing to have 
three versions: one which checked for a 
window specificaUon and opened a win- 
dow if indicated, one which always opened 
a window, and one which never opened a 
window. That would have invited too 
many opportunities for confusion and in- 
compatibility^ problems, I finally decided to 
follow ±e ROM Kernel example and write 
a module that would check for window 
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information. Then I was able to write a 
Fortran-cailable routine which would, if 
called, close the existing standard console 
I/O window, and open a new one, (There 
is always a console I/O defined; if no 
window is opened, WBInit.asm will open 
NIL:, so error messages will not crash the 
system,) 

My routine is called StdOpn.asm. It 
checks first to see If tiie program starts from 
CLL If it does, StdOpn returns quietly. If die 
program starts from Workbench, StdOpn 
closes the existing Console I/O window 
and opens a new one. It then hooks the 
new^ window into botii AmigaDOS and the 
Fortran mn-time system. This routine ac- 
cepts no arguments and opens only a 
specified default window. These limita- 
tions were acceptable for my purposes, but 
you might want to add arguments to spec- 
ify the size or type of window you desire. 
Yes, this is a bit of a kludge, but there 
appeared to be little choice. This way, at 
least, you can choose whether or not to 
open a window from witliin your applica- 
tion. 

To build the Fortran Workbench 
start-up environment, enter the assembler 
code provided in the attached listings for 
WBInit.asm and WB End. asm, using your 
favorite editor. Assemble tlie code using 
your favorite assembler, then link with 
Blink or Alink. No libraries are needed; 
simply type ''Blink wbinit.o to init.sc", 
"Blink wbend,o to wbend.sub", and "Blink 
stdopn.o to stdopen.sub". Note that the 
final files must be named init.sc, 
wbend.sub, and stdopn.sub (case is not 
important). Init.sc should be placed in the 
L: directory which will be used by tlie F77 
compiler. Also, note that tills module will 
replace the one provided by AbSoft, As 
always, be careftil to use a backup disk 
only, 

WBend.sub and StdOpn.sub should 
be in tlie same directory as tlie compiled 
program you will be starting from Work- 
bench. Your Fortran source code must be 
modified to do a CALL WBEND just before 
the END statement. Compile the Fortran 
source, then link in WBend,sub with the 
command; "F77L yourprog wbend.sub". 
Define an Icon for the program. Copy 
another Tool-type icon, using the SetWin- 
dow utility^ (from the Sofnvare Distillery) if 
necessary^ to establish a default window 
for the application. Workbench will not 
recognize this window, but some of the 
public domain utilities that emulate a 
Workbench start-up will. This way, you 
maintain compatibility with the way things 
are supposed to be. 
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When typing these programs in, 
watch out for a few things. When consider- 
ing variables, C, Fortran, and Metacomco 
Assembler are all case-sensitive. In other 
words, VAR, var, and Var are three different 
variables to these languages. When consid- 
ering commands, though, only C is case- 
sensitive. During the course of this project, 
I used both upper and lowercases. 

The program Testit.for demonstrates 
tlie new Fortran capabilities. Compile this 
program using F77j then link in 
WBEnd.sub using F77L. Make sure 
WBInit.asm has been assembled, linked, 
and named Init.sc. This module must be 
either in the same directory as Testit.for, or 
in the L: directory. You 
can link in the other subroutines, 
StdOpn.sub, Amiga.sub, and Loc.sub, as 
well as the run-time library. If you do not 
link these in, they still must be available in 
±e same directory as Testit. 

You can define an Icon for Testit by 
copying any Tool-rype icon and renaming 
it as Testit. info. I used tlie Calculator Icon. 
Edit the Testit icon using Workbench Info 
and then set the stacksize to suit your own 
liking. Tliis program does not use much 
stack, but you might want to take advan- 
tage of the ability^ to vary the stack size. 
Make sure the Icon is stored in the same 
directory as Testit. Then, click on the Icon 
and watch it run. 

Multitasking with Fortran and C 

In order to communicate between 
Fortran and C using this scheme, the first 
code module (in C) must stan the second 



module (in Fortran) using LoadSegO, and 
then CreateProcO. Then, the first code 
module must build and send to the new 
process a Stan-up message that looks like 
a Workbench message. This message will 
be collected in WBInit.asm and processed. 
The first module must be aware tliat the 
second will terminate by using ReplyMsgO 
to reairn tlie stait-up message. Therefore, 
the start-up message must not be touched 
by anyone during the course of the run, 

AkcT these requirements are satis- 
fied, the two processes may communicate 
according to any desired scheme — ^xvithin 
tlie context of AmigaDOS message -pass- 
ing. My application employs both message 
and token-passing, with well-defined 
handshaking to keep the processes from 
getting out of synch. There is no reason 
why die first code module cannot be writ- 
ten in Fortran and used to kick off another 
module in either Fortran or C. But I was not 
terribly interested in this case, and did not 
bodier to write a demonstration. 

The Workbench stait-up message is 
not immediately available to the Fortran 
application code, although it is available 
from witliin die initialization code. For my 
application, it is convenient that the Work- 
bench stan-up message be made available 
widiin the Foitran code, so I have written 
anodier little assembly segment (which 
could have been written in C). Tiiis seg- 
ment is Fortran-callable as a function and 
remrns the address of die start-up message. 
This function is labelled "'WBstrt.asm" in 
die listings. 
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An example of multi-process, multi- 
language communications is provided in 

the source listings under the names 
Master. c and Slave. for. Master^ after starting 
from CLI, builds the (fake) Workbench 
start-up message, kicks off Slave, then 
sends Slave the start-up message. Master 
tlien waits at its default message port (the 
same as tlie ReplyPort specified in the 
Workbench start-up message) for the first 
message tliat it expects from Slave. Master 
does not provide Slave with information on 
the current directory. Therefore, by default. 
Slave will have as its current directory^ the 
one from which the system booted. 

Slave collects tlie start-up message 
and processes it in WBlnit.asm. When the 
Fortran code is entered, Slave first does a 
FindTask(O) (using the Amiga. sub facilit\0 
to find its own Process Control Block, and 
then uses the WBstrt function to make the 
start-up message available from within 
Fortran. 

At this point, of course, Slave has 
already done a FindTask(0) from within 
WBInit. But again, that information is not 
available to Fortran witlioutanotlier special 
function. I wanted to keep the special 
functions to a minimum, so I had to do 
another FindTask(O) within Slave. 

Slave does a CreatePortO to provide 
itself with a standard message port for all 
interactions witli Master, It tlien does a 
PutMsgO to the ReplyPort specified in the 
start-up message. This, of course, is why 
we need the information in the start-up 
message. The PutMsgO contains the ad- 
dress of the standard message port thai 
Slave opened with CreatePortO, as well as 
the location of the first variable in a com- 
mon block, called com, which wOl be used 
by botli Master and Slave in diis demonstra- 
tion. Following the PutMsgO, Slave goes to 
sleep with a WaitPonO, looking at its new 
communication port. 

While all this has been going on, 
Master has been waiting quiedy for this 
message. When it arrives, Master stores the 
address of Slave's message port, then does 
a CreatePortO to generate its own message 
port. It then does a PutMsgO to Slave's 
message port, relaying the location of its 
own new message port. The port that it 
used for the Workbench message is not 
used again until it is time to close Slave 
down. 

Slave collects this message and does 
a ReplyMsgO to acknowledge receipt. At 
this point, all the initialization is finished. 
Master tlien sends a message to Slave 



which does nothing more than pass a text 
string to Slave. Sla\^e prints die text of the 
message for your edification, and does a 
ReplyMsgO. It then drops into a subroutine 
called USER, which represents tlie call to 
the main function of the Fortran package 
being integrated into diis environment. For 
diis demonstration. Slave does not use its 
console window for any other purpose 
than to post messages regarding its activi- 
ties. However, there is no reason why an 
interactive session could not occur In tliis 
window. 

USER commences w^ith a WaitPortO 
because it has nothing to do until it is 
activated by Slave's message. Master, hav- 
ing received the data on the location of die 
common area, has saved it and done a 
ReplyMsgO- It then does a PuuMsgO, send- 
ing three data values to Slave (which is now 
in USER). Using its console window. Master 
also tells us what it has done. It then does 
a WaitPortO, expecting a reply. USER has 
been expecting these values. It prints them 
in the console window to display what it 
has received, and then stores them in the 
common block. Next, it does a ReplyMsgO 
to Master, and then a WaitPortO. Master, in 
turn, does a DelayO, allowing us poor, 
slow humans to digest the information on 
the screen. 

Remember, Master knows die loca- 
tion of die common block or, more prop- 
erly, die location of the first variable in tiie 
common block. (Since variables in com- 
mon blocks are stored contiguously, it 
amounts to the same tiling.) Master reads 
the contents of the common block and 
prints them out for your pleasure. It then 
changes one of the data points in the 
common block and tells us what it is doing. 
Next, it does a PutMsgO to Slave, telling ii 
to print the data values in the common 
block. USER, of course, obeys. You will see 
tliat the value of the last variable in the 
common has indeed changed. After an- 
o±er DelayO, USER does a ReplyMsgO, 
then a WaitPortO- 

By now, Master has completed its 
planned itinerary, so it does a PuuMsgO 
telling Slave to shutdown. It then does a 
WaitPortO at its original message port. 
USER receives the command to shutdown 
and accordingly exits to Slave. Slave deal- 
locates its message port using a Delete- 
PortO, then calls wbend.sub to clean up. 
Master receives the ReplyMsgO to the start- 
up message message from wbend. When it 
gets an opportunity (remember, wbend 
disables multitasking, which is not re-en- 



abled until Slave exits), it does an Unload- 

SegO to delete Slave, frees all resources, 
and exits. All windows now close and aU 
system resources are returned. 

Slave. for contains a number of fea- 
tures that should be discussed. First, note 
the paired subroudnes, CreatePort and 
DeletePort. These functions are available 
as macros in botli Lattice C andMetacomco 
assembler. Nodiing comparable exists in 
Fortran, so 1 had to build them. They should 
be generally useful, beyond just this 
sample interface. 

Second, note that the message built 
widiin Slave uses space contained widiin 
the Fortran environment. I had originally 
done an Allocmem (using Amiga. sub) to 
prepare a block of memory, and dien a 
PutMsg to pass a pointer to that block. 
However, Amiga.sub bit me by passing a 
pointer to my pointer, instead of passing 
±e pointer itself. I could have gotten 
around diis either by writing an assembly 
routine that would work right, or by allocat- 
ing an array widiin Fortran. I chose the 
latter. I also did .\llocMems from widiin 
CreatePort. That worked because 
Amiga.sub correcdy handled AddPort and 
RemPort. Ho^-ever, FreeMem bombed for 
the same reason PuuMsg did. Given the way 
Fortran handles automatic variables, I did 
not consider it desirable to allocate my 
message port using space contained within 
the Fortran environment. Therefore, die 
best way around this was to write an 
assembler module diat correcdy handled 
FreeMem. This is die FreMem.asni module. 

Third, note die include statements in 
Slave. for. The include files provided by 
AbSoft provide an incomplete set of defini- 
tions. I needed a substantial number of 
additional definitions to make interface 
work. These definitions are contained in 
the include files DOSExtens.inc and 
Execextens.inc. Again, these files are gen- 
erally applicable and mimic exacdy die 
naming convendons found in the Lattice C 
include files. 

Conclusions and recommendations 

I have used the Fortran compiler 
extensively for a number of different appli- 
cations, some of which were quite com- 
plex. I have ported in multi-megabytes of 
software from the land of VAX, IBM 370, 
and IBM PC. I compOed 600K files in 
Fortran. The results were reliable. The 
compiler is fast with very few bugs, and the 
implementadon is complete — as far as 
ANSII standard F77 is concerned. It is truly 



98 Amazing Computing V4 J I ©19S9 



a shame that the hooks into AmigaDOS are so bad. 

Amiga, sub is a remarkable routine. I remember complaints 
about how terrible it was to have to go tlirough amiga Jib In Lattice 
C to get at the ROM Kernel. Compared to AbSoft's amiga. sub, 
amiga. lib is streamlined and elegant. Each library call takes hundreds 
of bus cycles J and some calls don't work correcdy due to bad data. 
Properly, AbSoft should provide a library — like Amiga. lil?^ — filled with 
routines such as the Fremem.sub that I have presented here. If AbSoft 
will not do itj someone else might consider it. 1 am building such a 
library as I need it. This article shows how it is done. 

Some aspects of tlie interface that I have shown here are ugly 
and clunky. These imperfections owe diemseives to the way AbSoft 
Fortran works. Nevertheless, tlie interface is reliable and provides a 
way for Fortran to reach the rest of the world — and for the rest of the 
world to reach Fortran. Using tlie routines provided here, you can 
make a standard Fortran application work with the Amiga multi- 
tasking environment. The multitasking communications capabiliUes 
might be of particular interest to those attempting multiprocessing 
with the Bridgeboard or a network. These should also be of interest 
to those who, like me, want to place a complex Intuition interface on 
a standard Fortran application. 

I have discussed some of tliese issues with AbSoft. Their com- 
ment is that I am one of very few people who are using Fortran in this 
way. Be that as it may, I emphasize that, since I knew it would be 
difficult, I did not attempt to use Fortran in this way until it was 
absolutely necessary. I cenainly would have used it in this way before 
if the implementation had supported it. Frankly, Ibr the features it has, 
I consider Fortran to be easier to program in dian C. 

About the author 

Jim Locker holds anMS. in Physics from Wright State Uniuersity. 
He works as a systems consultant at SoJTecb Inc. in Dayton Ohio. He 
uses bis Amiga lOOO^imth 4.5-MbyteRAM, a 20-MHz 6S020/68S81 
board, and an 80-MByte SCSI bard drive— as a simulation develop- 
ment system. When be isn't programming bis machine to simulate 
particle-beam systems or avionics systems, beflys radio-controlled 
model airplanes and cuts doivn trees to feed bis stove. A ny correspon- 
dence should be directed to: Jim locker, c/o Amazing Computing, P. O . 
Box 869. Fall River, MA 02 720. 



Listino One 



C 

C The 

C 



Process Structure 

integer pr_Process 
parameter (pr_Process = 0) 
integer pr_Task 

parameter (pr Task = pr_Process) 
integer pr_MsgPort 

parameter (pr_MsgPort = pr_Process+tc_MeniEntry- 
* tc__lsrode+8) 
integer pr_?ad 

parameter {pr_Paci = pr_MsgPort + 14) 
integer pr_Seglist 
parameter {pr_Segli St = pr_Pad+2) 
integer pr_StackSize 

parameter {pr_StackSi2e = pr_Seglist + 4) 
integer pr_GlobVec 

parameter (pr_GlobVec = pr_StackSi2e + 4) 
integer pr_TaskNum 

parameter (pr_TaskNum - pr_GlobVec + 4) 
integer pr_StackBase 
parameter (pr_StackBase = pr_TaskNum + 4) 



integer pr_Result2 

parameter (pr_Result2 = pr_StackBase -^ 4) 

integer pr_CurrentDir 

parameter (pr_CurrentDir = pr_Result2 +4) 

integer prCIS 

paraneter (pr_CIS ^ pr_CurrentDir + 4) 

integer pr^COS 

parameter {pr_COS = pr_CIS + 4) 

integer pr^ConsoleTask 

parameter (pr_ConsoleTask = pr_CIS ■!- 4) 

integer pr_FileSystemTa£k 

parameter (pr_FileSystemTask - pr_Con!:oleTa£:k - 4) 

integer pr_CLI 

paraneter (pr_CLI = pr_FileSystemTask +4) 

integer pr_ReturnAddr 

parameter (pr_HeturnAddr = pr_CLI + 4) 

integer pr_PktWait 

parameter (pr_PktWait = pr_Ret\irnAddr +4) 

integer pr_WindowPtr 

parameter {pr_WindowPtr = pr_PktWait + 4) 



^U^JKNOVJN ; pa r ame t er ( NT_UNKMGW?;= ) 
_TASK ;parameter{NT__TASK=l) 
INTERRUPT /parameter (NT_XNTERRUPT=2) 
DEVICE /parameter (NT_DSVTC£=3) 
WSGPCRT /parameter (NT_M5GP0RT=4 ) 
'message /parameter (NT_MESSAGE-5) 
JREEKSG / parameter (NT_FREEMSG-6) 
REPLYMSG /parameter (NT_REPLYMSG^7 ) 
RESOURCE /parameter (NT_RES0URCE=8 ) 
LIBRARY /parameter (NT_LI3PuARY= 9) 
MEMORY /parameter (NT_MEMORY-*IC) 
SOFT I NT / pa r ame t e r ( NT_SOFT INT= 1 1 ) 
_FONT /parameter {NT_F0NT=1 2) 
PROCESS /parameter {WT_PR0CESS=1 3) 
'semaphore /parameter (NT_SEMAPH0RE=14) 
_SIGNALSEM /parameter (NT_SIGNALSS-M-Z5) 
BOOTNODE ; pa r ame t er {NT_B00TN0DE=I 6 ) 



the node structure 



c nc 


jde definition 


c 






integer ^^T 




integer NT 




integer NT_^ 




integer NT 




integer NT_ 




integer NT 




integer NT 




integer NT_ 




integer NT 




integer NT 




integer NT_ 




integer NT_ 




integer NT_ 




inteaer NT 




integer NT_ 




integer NT 




integer NT_ 



integer*! Node (14} 
integer*4 ln_Succ 
integer* 4 ln_Pred 
integer*! ln_Type 
integer*! in_Pri 
integer* 4 !n_Name 

c 

c the node offsets 

c 

INTEGER LN_SUCC 
integer LN_PRED 
integer LN_TYPE 
integer LN_PRI 
integer LN_NAME 

c 

c port definitions 

c 

integer PF_ACTION 
integer PA_SIGNAL 
integer PA_SOFTINT 
integer PA_IGNORE 



The Message Structure 

integer mn_Message 
integer mn_ReplyPort 

integer mn_Length 



/ eqiai valence (Node (1) , ln_S'jcc) 

/ equivalence (Node (5) , ln_?red} 

/ equivalence (Node ( 9 ) , ln_Type ) 

/ equivalence {Node (10) ,ln_Pri) 

/ equivalence {Node (11) , ln_Na"^eV 



parameter (LN_SUCC ^ 0) 
parameter (LN_P RED = LN_S0CC-!-4) 
parameter (LN_TYPE = LN_PRED^4) 
parameter (LN_PRI = LN_TypE+l) 
parameter {LN_NAME = LN_PRI +!) 



/parame":er (PF_ACT:on = 3) 
/ pa r ame t er ( PA_S I GNAL - ) 
/parameter (PA_S0FTINT = 1) 
/parameter (PA_IGNORE = 2) 



/parameter (mn_Messace = 0) 
/parameter {mn_ReplyPort « 

mn_Mes£age+14) 
/parameter (mn_Length = 

mn__ReplyPort+4 ) 



c the msgport structure 
c 

integer*! MsgPort(34) 

integer mp_Node 

equivalence (MsgPort(l) ,Node (1} ) 
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integer*! mp_riags 






/***«**«»»»***** ij^i^ segment ***************/ 


equivalence (MsgPort US) ,nip_ 


_Flags :i 






integer*! mp_SigBit 






VOID mainO 


equivalence (MsgPort (16) ,mp_ 


SigBit) 




{ 


integer* 4 rap_SigTask 






struct Common *com; 


equivalence msgPort (17» ,mp_ 


_SigTa3k) 






integer mp_MsgList 






struct MsgPort *mainport; /* pointer to main process's 


equivalence {MsgPort (21) ,mp_ 


_MsgList} 




reply port*/ 


c 






struct MsgPort *ourSlaveport; /* pointer to Slave's new 


c the list structure offsets 






port */ 


c 

integer LH_HEAD 






struct Task *SlaveTask; /*pointer to Slave's TGB*/ 


parameter (LH^HEAD = 0) 








integer LH_TAIL 






struct SlaveMsg *m5g; 


paraireter(LH_TAIL = LH_HEAD+4) 






integer LH_TAILPRED 






static struct SlaveMsg wakemsg - 


parameter (LH_TAIL?RED = LH_ 


_TAlL+4) 




{ 


integer LH_TYPE 






[ { NULL , NULL , NT_MSS SAGE , , NULL } , 


parameter (LH^TYPE = LH_TAILPRED+4} 




MULL, NULL 


integer LH_PAD 






h 


parameter (LH_P AD = LH_TYPE+!) 




OKAY, "Wake up" 
}; 








static struct SiavsHsg checkmsg = 








{ {NULL, NULL, NT_MESSAGE,0, NULL}, 








NULL, NULL 


/* Header files */ 






OTHER, '^I have changed your data" 


finclude "exec/ types. h" 






}; 


f include "exec/ports -h'' 








finclude "exec/tasks. h" 






static struct SlaveMsg finalmsg = 


# include "exec /memory .h" 






i 


finclude "Uibraries/dos.h" 






{ { NULL, NULL , NTJ^SSAGE , , NULL } , 


iinclude "libraries/dosextens.h" 






NULL, NULL 


iinclude "'proto/exech*' 






), 


finclude "proto/dos.h" 






CLEANUP, "Perform clean-up" 


finclude "^woncbench/workbench.h" 






}; 


finclude "workbench/icon. h" 








finclude "workbench/startup. h" 






static struct SlaveMsg2 datamsg = 


tdefine SizTCB sizeof (struct Tas 


k) 




{ 
( (NULL,NULL,NTJffiSSAGE,0,NULL}, 
NULL, NULL 


/* definitions for other tasks * 


/ 




DATA, 3,14X59,2.7 31826,5,5 


fdefine SlavePriority /* priority for s 


Lave segment */ 


}; 


tdefine SlaveStack 4000 /* stack 


size for 


slave segment */ 


struct WBStartup *WBStartup; 


struct SlaveMsg 
{ 






struct MsgPort *WBrepiyport; 


Struct Message message; 






/* initialize messages and ports */ 


LONG code; 






WBStartup = NULL; 


char *text; 






WBreplyport = NULL; 

/* build the workbench startup message */ 


struct SlaveMsg2 

i 






if ((WBStartup = (struct WBStartup *) 


struct Message message; 






AllocMem(sizeof {struct WBStartup) 


LONG code; 






, MEMF_CLEAR) ) == NULL) 


double vail; 






goto errorA; 


double val2; 








double val3; 






/* create our message ports */ 

if ( (WBreplyport =» (struct MsgPort *) CreatePort ('"Master", 0) ) 


struct Common 






==0) 


/* LONG header;*/ 






i 
prion f("Unal3le to open WBMessage PortXn") ; 


double XXX ; 






goto errorO; 


double yyy; 






} 


double sze; 






if((mainport = (struct MsgPort *)CreatePort (0, 0) )«=0) 
I 
printf (""Unable to open main message portVn"); 








1 define OKAY 






goto error!; 


fdefine ERROR 1 






} 


tdefine CLEANUP 2 








tdefine OTHER 3 






/* load and create child process */ 


tdefine DATA 4 






if {(WBStartup- >sm_Segment « (BPTR)LoadSeg{^'Slave") )==0) 
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printf (^Tailed to load Slave\n"l ; 
goto error2; 

} 

if UWBStartup->sm_Process « (struct MsgPort *) 
CreateProc (""Slave", SiavePriority 

, WBStartup->smSegment 
.RiaveStack) ) == 0) 
{ 

printf (""Failed to create Slave processXn"); 
goto error3r 
} 

else 
{ 

print f (''Slave process createdNn"); 
} 
SlaveTask =s (struct Task *) ( (int) (HBStartup->sm_Proces$) 

-SizTCB}; 

/* send the startup messaga to Slave */ 

printf (""sending startup message to SlaveNn'"); 
west art up->sm_Mes sage. mn_ReplyPort = WBreplyport; 
PutMsgiWBStartup->sm_Process, WBStartup) ; /* send message */ 

Wait Port (WBreplyport) ; /* await an answer */ 
msg = (struct SlaveMsg *) GetMsg (WBreplyport ) ; 

/* This message is either a return of our startup message 
(indicating an errors or a standard message, containing 
the address of the new slave message port. We must test 
to find out which. */ 

if (WBStartup^>sm_Me3sage.mn_ReplyPort "» 

msg->message.mn_ReplyPort) 
1 

printf (""reply received - error in SlaveXn"); 
goto error4; 

print f ("'reply received -everything workingVn") ; 

/* get Slave's new message port */ 

ourSlaveport = (struct MsgPort *) msg->m9Ssage*nm_ReplyPort; 

/* get the location of slave's common area */ 

com = (struct Common *}msg->code; 

/* send the wakeup message */ 

wakemsg. message. mn_EeplyPort = mainport; 
wakemsg.message.mn_Length = sizeof (wakemsg) ; 
PutMsg (ourSlaveport, & wakemsg) ; 
WaitPort (mainport) ; 
GetMsg (mainport) ; 

/* send the data message */ 

printf ("^sending the data message to SlaveXn"); 

da t amsg. mess age. mn_Reply Port = mainport,* 

datamsg. message. mn_Length = sizeof (da t amsg) ; 

PutMsg (ourSlaveport, fidatamsg) ; 

WaitPort (mainport) ; 

GetMsg {mainport) ; 

printf (""reply receivedXn") ; 

Delay (500) ; 

/♦raid the slave common area to determine the data values*/ 

printf (""reading slave's dataVn"}; 

printf (""values are: xxx = %f, yyy = %f, zzz = IfVn", 
com->xxx, com->yyy, com->zzz) ; 

/* Now modify one of Slave's values for him */ 



The Bit Bucket 



COMPUTER STORE 

We Want Your Business!! 
We Have the Best Prices!! 

Oldest Commodore Dealer in the Area!! 

2 Locations to Serve You 



* Software 
* Hardware 
* Service 
* Information 




1294 Washington Street 

W* Newton MA 02165 

617-964-3080 

621 Boston Post Road 

Sudl>ury MA 01776 

508-443-9731 



Authorized Dealer 



Authorized Commodore 
Amiga Dealer and Com- 
modore Service Center 



Circle 139 on Reader Service card. 
cheG}ansg.message.mn_ReplyPort = mainport; 
checkmsg.mes3age.inn_Length = sizeof (checkmsg) ,- 
com->ZE2 = -2,23456; 

print f ("modifying zzz* New value is %f \r/', com->zzz> ; 
Futi'lsg (ourSlaveport, Scheckmsgj ; 
WaitPort (mainport) ; 
GetMsg (mainport ) ; 

/* send the "clean up" message */ 

print f (^'sending the cleanup messageVn"); 

finalmsg.message.inn_ReplyPort = mainport; 
finalmsg. message. mn_Length = sizeof (finalmsg) ; 
PutMsg (ourSlaveport, &finalmsg) ; 
WaitPort (mainport) ; 
GetMsg (mainport) ; 

print f(**reply received, .closing downVn") ; 

/* wait for Slave to ask to be unloaded */ 

Delay (100); 
error4 : 

WaitPort (WBreplyport) ; 
GetMsg (WBreplyport) ; 

/* clean up code */ 

RemTask (SlaveTaskJ ; 
errors : 

UnLoadSeg (WBStartup->sm_Segraent) ; 
error2: 
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BRIDGEBOARD USERS! 

Don't waste money, slots, or desk space buying extra 
IBM-compatibie or Amiga floppy drives! The Bridge Drive 
Commander gives you direct access to your built-in and add- 
on Amiga floppy drives from the Bridgeboard, and direct 
access to 360K and 720K tBM -compatible drives from 
AmigaDOS. Bridge Drive Commander makes access com- 
pletely transparent and automatic. No software drivers to load, 
no precious memory or expansion slots used up. Installs on 
internal floppy drive connector. Floppies are completely 
useable by other Amiga and IBM-compatible computers. 
Compatible with all software, hard disks, accelerator 
boards, etc. 

Two versions available: standard Amiga disk access, and 
mutti-bus version, for maximum speed. 

Bridge Drive Commander 

Standard access $ 79.95 

Multi-bus access $119.95 

External drive adapter .......$ 24.49 

MJ SYSTEMS 

Dept 1 0B, 1222 Brookwood Road, Madison, Wl 53711 

1-800^8^64 

Answered 24 hours 
MasterCard/ VISA (Info: 1-608-274-5563) 

Product names are trademajrks of their respectrve companies. 



Circte 169 on Reader Service card. 



DelecePort (mainportj ; 
error! : 

DeletePort {WBreplyport) ; 
errorO: 

FreeMem(WBStartup, si zeof (struct WBStartup) ) ; 
errorA: 

exit (0),- 



SLAVE. FOR 



include exec.inc 
include dos.inc 
include execextens.inc 
include dosextens-inc 
implicit none 

integer*4 ainiga,lQc,z, j, j j^mess 

integer*4 slavercv,oun!isg,slavetask, slaveproCrWbport 

integer*4 console, ourslaveport,wbnisg,wbstrt,rasgtxt 

integer*4 OKAY , ERROR , C LE ANUP , OTHER 

integer*4 code 

real*8 xxx,yyy,2rz 

character*l buf{64J 

character*24 mesage 

character*64 bufff 



C Our Message Structure 
C 

integer our_message 

parameter {our_nessage = 0) 

integer our^code 

parameter {our_code = our_message+20^ 

integer our_text 

parameter tour_t ex t - our_code+4) 



C Finish off the Task structure which is not done in 

C EXEC. INC 

C 

integer tc_UserData 

parameter (tc^UserData = tc_MemEntry+14) 

common /namblk/ z 

common /com/ xxx,yyy,2Z2 

character* 32 pname 

equivalence (buf f f , buf (1) ) 

data OKAY/0/,ERROR/1/, CLEANUP/ 2/, OTHER/3/ 



call stdopn 

pname « ^ourport' //CHAR{0) 

mess = loc (mesage) 

Find ourselves 

slavetask - aniga (FindTask, 0) 
slaveproc = slavetask 



C Now locate the workbench message and the location of the 

C reply port 

C 

wbmsg * wbstrt (0) 

wbport ^ wbmsg + mn_ReplyPort 



Create a new message port for ourselves 

call CreatePort {pname, 0, ourslaveport, slavetask) 



C If port creation failed, return W3 message 
C 

if (ourslaveport .eq. 0) then 
call amiga(ReplyI^sg, wbmsg) 
goto 99 

endif 
C 

C Otherwise send a message telling that we are running, 
C where the common block that we are going to use is 
C located, then wait at our port for the next message 
C 

long (mess+mn_EeplyPort) ^ourslaveport 

byte(mess+LN_TYPE) «= NT_MESSAGE 

wordCmess+mn_Length) = 24 

long(iness+our_code) = loc(xxx) 

call amiga (PutMsg, long (wbport) , mesage) 
call amiga (WaitPort, ourslaveport) 
slavercv = amiga (GetMsg, ourslaveport) 



msgtxt - long(slavercv+our_text) 

do 11 j-0,63 

buf ( j+1) ''byte (msgtxt+ j) 

if(buf(j+l) = CHAR(O)) goto 12 

continue 

continue 

write(9,15) (buf (jj) , jj=l, j) 

format pmessage received from Master"/, 64al) 

call amiga {Delay, 100) 

call amiga (ReplyMsg, slavercv) 



11 
12 



15 



C Now drop into the user routine, since all initialization 

C is finished 

C 

call USER (ourslaveport) 
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C We've exited the user routine, so clean up and go away 
C 

call DeletePort {ourslaveport) 
99 continue 

call wbend 

end 

subroutine USER^ourslaveport) 
include exec.inc 
include dos.inc 
implicit none 

integer*^ amiga, loc, j, j j 

integer*4 slavercv 

integer*4 ourslaveport , code^msgtxt 

integer* 4 OKAY , ERROR , CLEANUP t DATA , OTHER 

real*S xxx, yyy,zzz 

character*2 readin{12) 
C 

C Our Message Structures 
C 

integer our_message 

parameter (our_mes sage = 0) 

integer our_code 

parameter (our_code = our_message+20) 

integer our_text 

parameter (our^text = our_code+4) 

integer first^data 

parameter i firs t_dat a = our_code+4) 

integer second_data 

parameter (seconddata - f irst_data+8) 

integer third_data 

parameter {third data = second data+8) 



common /com/ xxx,yyy,zz2 

character* 32 pname 

character* 64 bufff 

character*! buf(64> 

equivalence (buf f f ,buf (1) ) 

equivalence (readin {1} , xxx) 

data OKAY/0/,ERROR/l/,CLSANUP/2/,OTHER/3/,DATA/4/ 

continue 

call amiga{WaitPort, ourslaveport) 
slavercv - amiga(GetMsg, ourslaveport) 
call amiga (Delay, 100) 
code = long (slavercv+our^Gode) -^1 



c 
10 



goto (20,20,30, 40,50) , code 
C 

C do nothing 
C 
20 call amAga(ReplyMsg, slavercv) 

write(9,22) 
22 format C^took the first branch") 

goto 10 
C 

C this is our cue to finish and go away 
C 
30 call ami ga (ReplyMsg, slavercv) 

write(9,32) 
32 format ("returning") 

return 
C 

C Print the values in the common block 
C 

40 continue 

msgtxt = long {slavercv+our_text) 
do 41 j-0,63 
buf ( j^l ) =byte (msgtxt^ j ) 
if(buf(j+l) = CHAR(O)) goto 42 

41 continue 

42 continue 

write (9, 44) (buf (jj), jj=l, j) 

44 format ("message received from Master"/, 64al) 
write {9, 45)xxx,yyy, zzz 

45 format ("XXX - ",fl2,9," yyy = ",fl2.9^, zzz = ",fl2.9) 




AVE HARD CASH 
* ON SOFTWARE... 



There are fabulous savings on all these goodies 

FREE mouse pad with orders 
over SI 00. 

Spellbound 28.95 

Super Scramble 29.95 

Sword of Sod an 35.95 

Test Drive II 29.95 

The Three Stooges 35.95 

Total Eclipse 29.95 

Triad (3 Games in One) 29.95 

TV Sports Football 34.95 

Where in V\/orld is Carmen 32.95 

Who Framed Roger Rabbit 32.95 

Who! What! When! Where! 65.95 

WordPerfect 159.95 

AND HARDWARE TOO! 

Epyx Joystick 14,95 

ErgoStick Joystick 19.95 
Internal 2W Floppy Drive 99.95 

MyT-Mouse 39.95 

California 3.5" drive 139,95 

Supra 2400 Baud Modem 129.95 

Spirit SC 501 Vi Meg 
Trapdoor Internal expan- 
sion with clock/catendar 
for Amiga 500. 0K 63.95 

plus shipping and handling 

Don't see it here? We've probably got it. Call us. 



AudioMasterll 


S69.95 


Aunt Arctic Adventure 


25.95 


Battle Chess 


34.95 


Battle Tech 


36.95 


Baud Bandit 


32.95 


Blood Money 


29.95 


Deluxe Music 2,0 


72.95 


Deluxe Paint III 


109.95 


Demon's Winter 


29.95 


DigiPaint III 


69.95 


Double Dragon 


29.95 


Dragon's Lair 


41.95 


Dungeon Master 


27.95 


FA/18 Interceptor 


37.95 


Falcon 


36.95 


Kind Words 


59.95 


License To Kill 


29.95 


Lords of the Rising Sun 


34.95 


OutRun 


34.95 


Phasar 


63.95 


Pioneer Plague 


28.95 


Publisher Plus 


49.95 


RoboCop 


32.95 


Rocket Ranger 


35.95 


Sinbad & Throne of Falcon 


19.95 


SimCity 


31.95 


Somx 


56.95 



SI 



COM P U T E R 



Your Amiga Source 

PO Box 57571 9 
Murray, Utah 84157-5719 
1 800 347 8004 




Circle 110 on Reader Service card. 



call amiga (ReplyMsg, slavercv) 
goto 10 



50 



con-cinue 



C Read the data values into the common block 
C 

do 52 j = 1,12 
52 readin(j> = word (slavercv + first_data + 2*(j-l)) 

write <9, 55) xxx, yyy, zzz 
55 format ("entering values into common'^, /, ''xxx ^",fl2.9, 
*//"yyy =", fl2. 9, /,"2zz =",fl2.9) 

call amiga (ReplyMsg, slavercv) 

goto 10 
c 

end 

subroutine CreatePort {pname, pri^mp, taskid) 
implicit none 
include exec.inc 
include execextens.inc 
include dosextens.inc 

integer*4 pri,mp,namloc, taskid 

character*32 pnaine , pname2 

integer*l nam(32) 

integer sigbit,amiga,loc, sizport, j,ourport,namsiz 

integer ourname 

common /namblk/ pname 2 
equivalence (pname2,nam) 

pname 2 =p name 
sizport = 34 
sigbit = amiga(AllocSignal,-l) 
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if(sigbit ,eq. 0) then 

mp = 

return 
endif 
ourport - aTniga(AilocMeinf sizport,MEMF_CLEAK .or, 

* MEMF_?UBLIC) 

if (purport .eq. 0) then 

call ainiga(FreeSignal,sigbit) 

mp = 

return 
endif 
ournane = amiga (AllocMem, 32,KEMF_CLEAIl .or. 

* HEMF_PUBLIC) 
if{ourname .eq. 0) then 

call amiga (FreeSignal^sigbit) 
call amiga (FreeMemjOurname, 32) 
mp = 
return 
endif 

do 5 j - 0,31 
5 byteCourname+j) = nam{j+l» 

ln_Naiiie - ourname 

ln_Pri = pri 

ln_Type = NT_KSGPORT 

mp_Flags = PA_SIGNAL 

mp_Sig3it ^ sigbit 

inp_SigTask - task id 
c 

c and add the port 
c 

iflnam(i) .ne, char{0)) then 
c 

c now move the defined structure into the allocated memory 
c 

do 10 i = O,sizport-1 
10 byte{ourport+j)=MsgPort (j+l) 

call amiga (AddPort^ ourport) 
else 
long(mp_MsgList+LH_HEAD)"mp_Ms9List+LH_miI. 
long (mp_MsgList+LH_TAILPRED) =mp_M3gList+LH_HEAD 
long (mp__MsgList+LH_TAIL) ^ 

do 15 j = O,sizport»l 
15 byte(ourport+j)=MsgPort lj+1} 

endif 

mp = ourport 

return 

end 
c 

c delete the port 
c 

subroutine DeletePort (port) 

integer port 

integer amiga,loc 

include exec.inc 

integer sizport,siznam,memfre,durr; 



the node offsets 

INTEGER LN_SUCC 

parameter (LN_SUCC = 0) 

integer ln_pred 

parameter (LN_P RED - LK_SUCC+4) 

integer LN_TYPE 

parameter (LN_TY?E = LN_PRED-f4) 

integer LN_PRI 

parameter (LN__PRI ^ LN_TYPE + 1) 

Integer Lt4_NAME 

parameter (LN_E^AME - LN_?RI +1) 

sizport = 34 

siznam = 32 

memfre = long (port + LN_NA>E) 

if (long(memfre) .eq. 0) then 



call amiga (Remove, port J 
else 

call amiga(RemPort,port) 
endif 

call Fr emem (mem f r e , s i 2 nam) 
call Fremem(port,sizport) 
return 
end 



STDOPN version 1 .0 



INCLUDE "exec/types. i" 
INCLUDE "exec /ale rts.i'' 
INCLUDE "exec/nodes. i" 
INCLUDE ^^exec/lists.i" 
INCLUDE "exec/ports . i" 
INCLUDE ^^exec/ libraries . i " 
INCLUDE "eKec/tas)cs.i" 
INCLUDE "libraries/dos.i'' 
INCLUDE "libraries/dosextens.i" 
INCLUDE '^workbench/startup.i'' 



AEXEC EQU 


-16 


DOS EQU 


AEXEC-4 


STDIN EQU 


DOS- 4 


5TD0UT EQU 


STDlN-4 


H.BASE EQU 


STDOUT-4 


H.SIZE EQU 


K. BASE' 4 


WBSTAT EQU 


K.SIZE-2 


workbench? 




W3MSG EQU 


WBSTAT- 4 


OURTSK EQU 


WBMSG-4 


AMIGA EQU 

* 


-OURTSK 


* - from '^dos 


.library** 


_LV00pen 


EQU -30 


_LVOClose 


EQU -36 


STDOPEN: 




tst. 


w WBSTAT (AO) 


bne. 


s contnu 


rts 




contnu : 





"exec^iib" pointer 
Mos .library" pointer 
file handle for STDIN 
file handle for StdoUT 
base of heap 
size of heap 
running from 

loc of WB message 
loc of our TC3 
size of Amiga global 
storage 



* did we start from wor)tbench? 

* no. 



movem.l A0/A4/A6, - (A7) 

movea.l DOS(a0),A6 

move.l STDIN (A0}/D1 

jsr _LV0Close{A6) 

movea.l ihl) ,AQ 

lea winD0(PC),A3 

move.l A3,D1 

move.l #M0DE_0LDFILE,D2 

jsr _LVO0pen(A6) 

movem.l (A7)+,A0 

move.l DO, STDIN {AO) 

move.l DO, STDOUT (AO) 

move.l STDIN (AO) ,S9b0(A0) 

move.l STDOUT (AO) ,$AF6(A0) 



* save some stuff 

* get the DOS lib 
pointer 

* get the old scdio 
file handle 

* and close it 



open the new 



* sticjc the file 
handles where 

* they are needed 



set the console tas)t (so Open ("'*'', mode) will work) 

movea . 1 OURTSK { AO ) , A4 

Isl.l i2,dO 

move.l dO,aO 

move.l fh_Type{aO) ,pr_ConsoieTask (A4} 

movem.l (A7)+,A4/A6 

rts 



HINDO: 



dc.b *CON:0/0/640/100/FORTRAN CLI' 
dc.b 
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program testit 

include exec.inc 

include dos-inc 

integer*4 amiga.ip 

call stdopn 

ip ^ amiga {Open, "Con; 10/100/320/100/testit", 

* MODE_NEWFILE> 
if<ip .eq. 0) goto 99 

call WritStr (ip, "Hello from WorkBench Startup") 

WRITE (9, 9) 
9 Format (Ix, "Hello from our first new standard window") 

call amiga (Delay, 100) 

call stdopn 

write(9,19) 
19 format (Ix, "Hello again from our second new standard 

* window") 
call amiga (Delay, 100) 
call amiga (Close, ip) 

99 continue 

call wbend 

end 

subroutine WritStr (file,msg) 

include dos.inc 

integer file, amiga 

character*! msg(29) 

msg(29)^ z'O' 

call amiga (Write, file, msg, 29) 

call amiga (Write, file, "\n",l) 

return 

end 



WBEND version 1 .0 



AEXEC 


EQU 


-16 


* 


DOS 


EQU 


AEXEC-4 


*■ 


STDIN 


EQU 


DOS -4 


* 


STDOUT 


EQU 


STDIN-4 


* 


H.BASE 


EQU 


STDOUT- 4 


* 


H.SIZE 


EQU 


H.BASE-4 


■* 


WBSTAT 


EQU 


H.SI2E-2 


* 


WBFiSG 


EQU 


Vr5STAT-4 


* 


OURTSK 


EQU 


WBHSG-4 


* 


AMIGA 


EQU 


-OURTSK 


* 


* - from "exec 


.library" 




LVOForbid 


EQU 


-132 


LVOFreeMem 


EQU 


-210 


_LVOReplyMsg 


EQU 


-378 


LVOCloseLibra 


ry EQU 


-414 


_LVODebug 


EQU 


-114 



''exec_lib" pointer 

"dos , library" pointer 

file handle for STDIN 

file handle for STDOUT 

base of heap 

size of heap 

running from workbench? 

loc of WB message 

loc of our TCB 

size of Amiga global storage 



* - from "dos, library" 
_LVOClose EQU 



-36 



WEEND: 



tst.w WBSTAT(AO) * did we start from worlcbench? 
bne.s contnu ^ no. 



grab the WB message pointer 
move in DOS lib pointer 
move in STDIO pointer 
if no STDIO, skip 
close STDIO 



contnu: 








MOVE.L 


A0,"(A7) 




MOVE . L 


WBMSG(A0},D2 




MOVE . L 


DOS(A0),A6 




MOVE . L 


STDIN (A0),D1 




beq.S 


skip 




jsr 


LVOClose(A6) 


Skip: 








MOVE A. L 


a6,ai 




MOVEA.L 


(A7)+,A0 




MOVE.L 


AEXEC (AO) ,A6 



* prepare to close DOS lib 



Dsr 



_LVOCloseLibrary (A6) 



move in EXEC lib 

pointer 

close DOS lib 



Come see whats Hot 

for the AMIGA at 

The Memory Loc ation 





The 

Memory 

Location 










396 Washington Street 
Wellesley. MA 02181 

(617) 237-6846 

AMIGA Experts I Nothing but the best. 

Satisfaction guaranteed. 

Come in and try-out all the latest software, 

hardware, and accessories. 

Your full service AMIGA dealer. 

Store hours: Mon.-Thur. 10-6 Friday lO-S Saturday 9-5. 

Full Commodore authorired repair service onsite. 

Low flat rate plus parts. 

Circle 107 on Reader Service card. 



jsr 



LVOForbid (A6) 



MOVEA.L D2,A1 

jsr _LVOReplyMsg (A6 ) 
rta 



so workbench can't 
unloadsegO us 
until we' re done 
* reply to the 
workbench msa 



********* ** 



INCLUDE 

INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 



WBInit.asm-FORTRAN Compiler Startup Code 
Substantially based upon the 
ABSOFT CORPORATION FORTRAN 77 COMPILER 

r********* ****** 



It ****** 



****** 



''exec /types.!" 
"exec/alerts. i" 
*'exec /nodes, i" 
"exec /lists ,i" 
"exec/ports . i** 
''exec/libraries.i'' 
"exec/tasks . i" 
'*libraries/dos .i" 
''libraries/dosextens . i" 
'' workbench/ St art up. i" 



* - from '"depsys" 

AEXEC EQU -16 * "eKec_lib" pointer 

DOS EQU AEXEC-4 * "^dos . library" pointer 

STDIN EQU DOS- 4 * file handle for STDIN 

STDOUT EQU STDIN-4 * file handle for STDOUT 

H.BASE EQU STDOUT- 4 * base of heap 

H.SIZE EQU H.BASE-4 * size of heap 

WBSTAT EQU H.SIZE-2 * running from workbench? 

WBMSG EQU was TAT- 4 * ioc of W3 message 

OURTSK EQU WBMSG- 4 * loc of our TCB 

AMIGA EQU -OURTSK * size of Amiga global storage 
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F77.RL 


EQU 


17408 


PCB 


EQU 


3348 


WO OP 


EQU 


$4E71 



* size of '*f77.rl" 

* hex of NOP instruction 



» - from "exec lib" 



LVOAlert 


EQU 


-108 


'LVOForbid 


EQU 


-132 


LVOAllocMem 


EQU 


"198 


LVOFreeMem 


EQU 


-210 


YvOFindTask 


EQU 


"294 


^LVOWait 


EQU 


-318 


\vOGetMsg 


EQU 


-37 2 


^LVOReplyMsg 


EQU 


-378 


^LVOWaitPort 


EQU 


-384 


LVOOpenLibrary 


EQU 


-552 


^LVODebug 


EQU 


-114 


:XEC.LIB 


EQU 


4 * poiater to **eKec_lib 



from ^dos, library" 



LVOOpen 


EQU 


-30 


LVOClose 


EQU 


-36 


LVORead 


EQU 


-42 


LVOWrite 


EQU 


-48 


LVOInput 


EQU 


-54 


LVOOutput 


EQU 


-60 


LVOCurrentDir 


EQU 


-126 


LVOExit 


EQU 


-144 


LVODelay 


EQU 


-198 



* - the following code is already in the source file: 
* 

* START: LEA START (PC) , Al * load address of entry point 
MOVEA.L A1,A2 

* ADDA.L fOFFSET.Al * pointer to main program 

* ADDA.L #0FFSET/A2 * pointer to end of data section 

* MOVE.L #HEAP,D1 * heap size 

* MOVE.L #RUN,D2 * run-time library specification 



CLR,W 


MBS tat 


CLR.L 


WBenchMsg 


JI-P 


SI (PC) 


NO? 




NOP 





SI: 



S2: 



MOVE.L D2,-(A7) 

MOVE.L AO,_DosCmdBuf * copy command line pointer 

MOVE.L A4,-^A7) * stow original A4 safely away 

MOVE.L DO,_DosCmdLen * copy conrtraand line length 

MOVEA.L A1,A2 * Gopy for global use 

SUBA.L A1,A1 * find our own task 

JMP S2(PC) 

NO? 

NOP 

MOVE.W #_LV0FindTask,D6 

BSR ECALL 

MOVE.L D0,A4 

tst.l pr_CLI(A4) 

bne from_Cli 

open the "dos. library" and locate STDIN and STDOUT 



fromWB: 



move.w #lli,_WBotat 
MOVEM-L D2/A2,-(A7) 
MOVE.L #l,_DosCradLen 



BSR 


DOSOPEN 


lea 


pr_MsgPort {A4),A0 


move . w 


t LVOWaitPort,D5 


BSR 


ECALL 


JMP 


S3{PC) 



* make the run time 
library happy 

* our process base 

* wait for wbench message 



LINKED: 



NOP 



S3: 



NOP 
NOP 
NOP 
NOP 
NOP 
NOP 

lea pr_MsgPort {A4 ) , AO 

move.w #_LV0GetMsg,D6 * get the message 

BSR ECALL 

move.l dO , _WBenchMsg " save it so we can 

return it 

move.l D0,A2 * get the first argument 

Move.l sm_ArgList (A2} ,D0 

beq.s do cons 

set the current directory to the same directory 

move .1 DO , AO 

mo ve . 1 wa_Loc k ( AO ) , dl 

move.w #_LV0CurrentDir,D6 

BSR DCALL 



do cons : 

* 

* - get the toolwindow argument 

move.l sm Toolwindow (A2) ,dl 



* is there a default 
window? 

* yes 

* no default, so open 

NIL: 



bne . s opawndo 
lea NIL (PC), A3 

move.l A3,D1 
BSR FILOPEN 
bra.s lilhandl 

* 

* - open up the file 

opnwndo : 

BSR FILOPEN 

* - set the i/o descriptors 
* 

fiihandl: 

move.l dO,_stdin 

move.l dO,_stdout 

beq.s domain 
* 

* - set the console task (so Open (***", mode) will work) 

* waitmsg has left the task pointer in A4 for us 
* 

Isl.l #2,d0 
move.l dO^aO 
move.l fh_Type(aO) , pr_ConsoleTask (A4) 



domain: 



MOVEH , L ( A7 ) + , 02 / A2 
MOVE.L _s tart keep, A2 



» - allocate the heap segment and establish global addresses 

f rom_Cli : 

KOVEA . L _Dos CmdBuf , A3 

MOVE.L _DosCmdLen,D5 

MOVE.L #AMIGA+?CB, DO * module size 

MOVE.L #N0_0P,D7 * find out if run time lib 
* is linked 

CMP.W LINKED+4,D7 

BNE S4 

ADD.L #F77.RL,D0 * if not, need space for it. 



34: 



MOVEQ #0,D1 * MEMF_FAST first, then 

MEMF_CHIP 
MOVE . W #_LVOAllocMem, OS 

MOVE.L D0,D4 * save allocated size 

BSR ECALL 

TST.L DO * did allocation succeed? 

BEQ ERROR * no 

MOVEA.L DO,AO * Set pointer to base of 

heap 
MOVE*L A0,D3 * save pointer for ''f77.rl" 



106 Amazmg Computing V4.n ©1989 



MOVE.L #N0_0P,D7 

CMP.W LINKED+4,D7 

BNE S5 

ADDA.L #F77.RL,A0 



^f77.rl" 

* 

for 



ADDA.L #AMIGA,A0 
MOVE.L DO.H.BASEIAO) 



MOVE.L D4,H,SIZS{A0) 



load 

find out if run time lib 
is linked 



* if not, allocate 



* allocate global area 

' save base of heap 

.FREEMEM. 
* save sise of heap 



for 



.FREEMEM. 

* set pointer to 
^■"exec^lib" 

* pick up stdin and 
stdout from WB 



MOVE.L EJCEC.LIB,AEXEC(AO) 

MOVE.L _stdin, STDIN (AO) 

MOVE.L _Std0UC, STDOUT (AO) 

MOVE.L _DOSBase,DOS(A0) 

MOVE.L _WBenchMsg,WBMSG(AO) 

MOVE.W _WBStat,WBSTAT(AO) 

MOVE.L A4,OURTSK(AO) 

MOVEA.L (A7)+,A4 ^restore original A4 

open the "dos . library" and locate STDIN and STCOUT 



TST.H _WBStat 

BNE.S BYPASS 

BSR DOSOPEN 

MOVE.L DO,DOS(AO) 

BNE.S LI 
ERROR; RTS 



* running from workbench? 

* yes.. DOS already open 

* open DOS 

* save pointer, error? 

* did open succeed? 

* no, fail silently 



LI: MOVEQ #_LV0Input,D6 

BSR DCALL 

MOVE.L DO, STDIN (AO) 

MOVEQ #_LV00utput , D 6 

BSR DCALL 

MOVE.L DO, STDOUT (AO) 
BYPASS: 
* 

* Now find out if the run time library is linked in. We 

* test the location that is 4 bytes past the LINKED label. 

* If it contains a NOP then the linker has not linked in 

* the run time library. If the value is different, then 

* the linker has stepped on us, with the following code: 
* 

* LEA START (PC ),A5 

* ADDA.L #OFFSET,AS 

* JMP (A5) 
* 

* In this case we branch to LINKED and execute the code 

* we find there. Otherwise, we just fall through and find 

* the run time library. 
* 

MOVE.L #N0_0P,D7 

CMP.W LINKED+4,D7 

BEQ FNDLIB 

MOVE.L (A7)+,D2 

BRA LINKED 

* - locate and load ''f77.rl" 

FNDLIB: 

LEA F77LIB+6(PC),A6 

MOVE.L D2,D0 * load run-time library 

* specifier 

LSL.L #4, DO * calculate table offset 

ADDA.W D0,A6 * index specified library 

MOVE.L a6,D1 * "name" 

move.l tM0DE_0LDFILE,D2 

move.w #_LV00pen,D6 

BSR DCALL 

MOVE.L D0,D7 * found in local library? 

BNE*S L2 * yes 

SUBQ.L #3,D1 

BSR DCALL 

MOVE.L D0,D7 ^ found in current volume 



The Disk Mechanic 



Give your disks o lune-up 




Onlv $89.95 





Simple Turtcl-pbfnch?mrV,Tt"«i,wi.TinJir J I ^lUai 




v^wmttmt TiPtUr iiicni M1IH jmntiivii^ 




Vt««ka«*Ul JH tts t.1« Tf-v 




n*»> i:ti t.u jjj »■. 




Vlwif»rfK( A-.*2 Jl.it SJT l»\. 




^.prrlLw J:i7 H,» ^M l«% 




itM l:*J M..» 4M aW- 








• Tirne^ (Km are ihr avenp<- iH" ihnrc runr I'm j lundirj 

AXKKJ 1 n(crna) Oif^ drrvE The Taw L'p time <* she 1 1 nie 

BEFORE *nd AFTER nmc* art t\x (iw (ha wiW*) 
reijuittidififfiJiJifViiciryrTfihrditL T>k rmwr uh- j J «k 







Dema dlsl^ Avaitabk: call Tor detitJk. 

Lake ForesI Logic Inc. 

28101 e Bollard Rood 

Loke Forest, IL 60045 

(312)816*6666 



The Disk Mfchank U a comprehensnT 
coileclion or utiUlics for Am\f.a DOS, 
inctuding TuncUp, Double Racfc, 
DiskKcpatr, iirKl Workshop 

TuncUp: Wiih TuficUp >txi car imrP'T^'c 
haul disk or floppy di^k pcrforrriancc 
by up ID 400%. Npt a cuching pnjBTam, 
TuncUp is B saphisdcaisd di^ ojxvnittt 
ihai aenully re-ctjarnnts ihc infomuiion 
on youf dKk in impiTivc syiicni cTfl- 
dcnry. TifrcUp i^ fully cunipaiiWc 
ui[h Amigj DOS 

DoubtfBick: Double Back ii a liifih 
speed inrhival hird diilc back-up pro- 
^im. DoublcBKk suppant muliipk 
source md desnntiion driven, (ile 
selection by nsme. date, pfotection. 
directofy. and filf note BKk up i full 
20 mergabyies in urvdcr JO ininure^. 
Sdeciively copy fde* berwttn hard 
diiks and panftirm^ Rmicct j-our djiJi' 

DiikRefHlr: Witfi DiskRqsair ii is poKibte to recover KOdcmJy 
deleled or discifdcid fdes. salvage file* fmm damai^ed tlisiVt. 
and rcconsimciicoRypted banJ disk Disk Repair works wiih 
hard and floppy disks, AM '\% compatible with the Fast f-Hine 
System 

WorkShoi>: For the expert user, the disk Workshop is a full 
feaiuitd disk file and block editor. Enamine and modify disk 
Tiles, search for vimses, ind change menus or requesters in 
popular programs 

The Disk Mechanic a1$o include* i doien small CM ha*cd 
ulililie? to make manaBinB your disks easier, We are imv, 
shippini version 2 5 with full tuppon for Amiga tiOS 1 y 
and the FiJt Filing System. The Disk Mechanic ii nm copy 
pttntciesi 

COMING SOON: 
Sniper! 

The Ulltmalc PLiinl And Shocn DiFk Manager 

Afacropaint 

A High Resolution SlructuTKl Graphic* Packipp 



Circle 113 on Reader Service card. 



L2: 











library? 


BNE . S 


L2 




* 


yes 


SUBQ.L 


#3,D1 








BSR 


DCALL 








MOVE . L 


D0,D7 




* 


found in system volume 
library? 


BEQ.S 


L3 




* 


no 


MO\TA.L 


D3,A5 




* 


set pointer to ''f77.rl 


MOVE . L 


D7,D1 




* 


^file'^ 


MOVE.L 


A5,D2 




* 


"buffer'' 


MOW.L 


#F77.RL,D3 




* 


'"length" 


MOVEQ 


# LVORead, 


D6 






BSR 


DCALL 




* 


load the library 


TST.L 


DO 




* 


error? 


BMI.S 


L3 




ilr 


yes 


MOVE.L 


07, Dl 




* 


"file" 


MOVEQ 


# LVOClose 


D6 






BSR 


DCALL 




* 


close the file 


MOVE.L 


(A7)+,D2 




* 


run-time library 
specification 


JMP 


(A5) 




* 


transfer control to 
"f77,rl" 



* - '*f77.rl" load failed; report error a.nd quit 



L3: 



MOVE.L 


STDOUT (AO), 01 






* ""file" 


LEA 


ERRMSG(PC),A6 








MOVE . L 


A6,D2 






* "buffer 


MOVEQ 


#30, D3 






* ""length 


MOVEQ 


# LV0Write,D6 








BSR.S 


DCALL 








MOVE,L 


DOS(A0),,-(A7) 


* save 


Dointer to 






"do 3 


.1 


ibrary" 



3SR.S DCALL 

MOVEA . L H . BASE (AO ) , Al 

MOVE.L H.SIZE{AO},DO 

MOVE.W # LVOFreeMem, D6 



* pointer to module to delete 

* size of module to delete 



Amazing Computing V4 J 1 01 989 107 





ytv 






MOVE.L (A7)+,D2 








/ 


\ 




rts 




MOVING? 


/ 






? 


D0SLI3: DC.B *dos. library' 






i 1 ^ 




DC.B 


















F77LIB: DC.B *sys:l/f 77, rl' 






SUBSCRIPTION PROBLEMS? 




DC . L 








RDWLIB; DC.B ^sysil/hdw. rl' 








DC.L 




Please don't forget to let us know. 








If you are having a problem with your 




M81LIB: DC.B ^sys:l/ni81 . rl' 
DC.B 




subscription or if you are planning to 








move, please write to; 




ERRMSG: DC.B *?cannQt load run-time library' 
DC.B 10,0 

NIL: DC.B ^NIL:' 




1 


DC.B 




Amazing Computing Subscription Questions 




_HBStat: DC.W 




PiM Publications, inc. 




_stdin: DC.L 
_stdout: DC.L 




P.O. Box 869 




errno: DC.L 




Fail River, MA 02722 




_WBenchMsg: DC.L 

_DosCmdBuf; DC.L 

DosCmdLen: DC.L 

_DOSBase: DC.L 










Please remember, we cannot moil your magazine 
to you if we do not know where you are. 












WBStrt version 1 .0 














AEXEC EQU -16 * "exec_lib" pointer 










DOS EQU AEXEC-4 ♦ ^dos. library" pointer 




Please aifow four to six weeks for processing. 




STDIN EQU DOS-4 * file handle for STDIN 
STDOUT EQU STDIN-4 * file handle for STDOUT 
H.BASE EQU STDOUT-4 * 'tia^% of heap 
H.SIEE EQU H.BASE-4 * size of heap 






HBSTAT EQU H.SIZE-2 * running from wor}cbenc>i? 




WBMSG EQU WBSTAT-4 * loc of WB message 


BSR.S ECALL 


OURTSK EQU WBMSG-4 * loc of our TCB 


MOVEA.L (A7)+,A6 * pointer to "dos. library" 


AMIGA EQU -OURTSK * size of Amiga global 


MOVEQ #10(*D1 * ""something wrong" 


storage 


JSR _LV0Exit(A5) 






* - from "^dos, library" 


* 

* - execute "exec^lib" call (offset passed in D6) 


WBStrt: 


* 


tst.w WBSTAT(AO) * did we start from 




workbench? 


ECALL: KO^/EM.L D1-D7/A0/A2/A3/A5, - (A7) 


bne.s contnu * no. 


MOVEA.L EXEC. LIB, A6 


rts 


JSR 0{A6,D6.W) 




MOVEM.L {A7)+,D1-D7/A0/A2/A3/A5 


contnu: 


RTS 


move.l WBMSG (AO), DO 


* 

* - execute "^dos. library" call (offset passed in D6) 


rts 




FREMEM 




DCALL: KOVEM.L D1-D7/A0/A2/A3/A5, - (A7) 








MOVEA.L _DOSBa3e,A6 


_LVOFREEMEM EQU -210 


JSR 0(A6,D6.W) 




MOVEM.L (A7)+,D1-D7/A0/A2/A3/A5 


FREMEM: 


RTS 


MOVE.L 4(A7),A3 * LOAD POINTER TO MEKB LOCK 




* SIZE 


DOSOPEN; 


MOVE.L (AS), DO *LOAD MEl^LOCK SIZE 


LEA DOSLIB{PC) ,A1 * ^dos, library" 


MOVE.L 8(A7),A3 * LOAD POINTER TO MEKB LOCK 


MOVEQ #0,D0 * any version will do 


* POINTER 


MOVE.W #_LV00penLibrary,D6 


MOVEA.L (A3),A1 *LOAD MEMBLOCK POINTER 


BSR ECALL 


MOVEM.L A0/A4-A6,-(A7) *SAVE EVERYTHING WE NEED 


MOVE.L D0,_DOSBase * save pointer 


MOVEA.L 4,A6 *M0VE IN EXEC LIB POINTER 


RTS 


* move.l d0,-(a7) 




* move.l #0,dO 


FILOPEN: 


JSR -114 (a6) 


MOVE.L D2,-(A7) 


JSR _LVOFREEMEM (A€ ^ *FREE THE MEMORY 


move . 1 #M0DE_0LDF I LE , D 2 


MOVEM.L (A7)+,a0/A4-A6 *REST0RE EVERYTHING 


move.w #_LV00pen,D6 


RTS 


BSR DCALL 


•AC* 
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The Fred Fish Public Domain Software Li 


Drary 


The Fred Fish disks are collected by Mr. Fred Fish, a good and active friend of die Aiiiiga. 




MJTor Wars Anew ostse fea&ifing sound, sue music, and (*o 




allow any wrtes» the disk. A hiy functional 


Bilytli Amiga potot the tDrmerarcade gams iwT»ed 


player mode. Vou fight yo<x opponent via User 


(or your tisks, Ths is version 2-5. an update to 


verscn is availabte tor a very reasonable price 


CiidL "Ris version fc^ some minor byg» and 


rays, but beware of fte mirrors reflecting you- 


verstDnl^Sromt£sk210. Shareware. txnary only 


from CONSULTRON. Verson 3.02. tinary onfy. 


is faster t!w(ife previous vef^bns. TKsis 


shos. Binary orty. Author CXwer Wagner 


(souiceavailaWetromautnorl.AuJior Andreas 


Autto: CO*JSU_TRON. Leonard Poma 


verscn 1 1 1, an update to ttie viersi&n reteased on 


Fred Fish Disk 236 


Krebs 


Dis An AmigaDOSsftareaUe library wtijch 


disk 221. Binary 0^ charCTiare. Author: 


AmigaBencn Qplkiied Amiga assembly versions ol tie 


NGC Yei another viniis check prog ram , Checks the 




Oliver Wagne; 


Dfirystorw befiiimark, inckiites 68000 arxJ 68020 


bootblock on ai inserted fioppy disks and r^x^s 


dsassembief lortfw MCS8000 fam^ and c- 


Dtjug Machlwindepenctemmactt) based C 


vefs«xis,Ai;Sxir; AlAburto 


nonstandard ones. Checks ihejump laWes o! afl 


program which uses ihe ibrary to disassembfa^ 


debuflfffiO package. Provides funciiofl trace, 




resident libraries and devices and reports 


dump AmigaOOS object files, making lull use of 


Eelectiw printing o! tnler;^ state tntormaton. 


that reads aixj wr,ites 1 ,? format ttskeiies, 


suspicjous entries, Version 1 . tf^ludes source in 


symbolic and relocation inlormation. Includes 


and more. Ths is an updai© lo the version 


Indudes source. Author: Sof^ore Distillefy 


asse.nbf/.Autfxjr: UHNordquist 


source code in D^aco. Author: Chris Gray 


released wi disk 102, a^ nw IndDdes a 


Hearts D A program to find left venttK^ outines i n !ha 


P)th A progran to draw the Tree ol Pythagoras. 


DfJ-Maps IFF maps to flia Dt^eon faster game, AI : 4 


m^cttine indepertdent stacft use accounting 


output of an Imatron CT scamer. and display 


Version t .1 . indudes soyrce. Atrthor: Andreas 


tere'.s a/e ffidiKfed. Author Unknown 


medianism. Includes soutte. Author: Fred 


wirefrajTie animations of the beating heart 


Krebs 


Mem Ub A r<nk Sbrary of rcusines to aid in debug^g 


Rsh: profihg support by Binayak Bartefjee 


IndudesseveraJsampfeCT scan outputs. Binary 


StefiscHag A tetrijHte game (SieinscMag means *FaSflTg 


memory problems- Works with Lattioe C 5.0 and 


HeSounceDciTK) A diemo version of ReSounra, an 


oriy, Aulhx: Jonathan Harman 


RodC] submitted by the author. This is version 


possibly wiihearServersisns. irsteati/es 


interadjve disasse*5ib'er for Sie Amiga, Ths is 


Ls Version 3.t of th,^ poplar UMX styte dreciory 


1.8. an uodate lo vefS»on 1,5 torn dffik £21 , 


tndude trashing all aftoca'iisj memory, f asning 


a com p(e* version except ttBllre 'save' 


feier. Ths is an updaie to version 10 Irom cSsk 


Binary only. Au£tor:Peieff^a/<iet 




feaiures have beer dsaWed. This is version 


1 7B, and lidudes some bog lies, fijpport tor 


Fred Fish Disk 239 


wiflt noSBca&m i it is wriaen to, notificaiion of 


3.G£, an. i^ie to '/ersion 0.36 tram dsk 132. 


ri Lis pie wildcard pathnames. Cfjicker soiling, a 


FF 239 contains Forth programs frcm Ihe JGoocte it dsk. 


mewwy fteed iwicc Of not at al. noificalion of 


B.naryt^.Amhor GlenUcOiannd 


besl-£t oU5xit. new output wknh and height 


trom EJofta Researdi (the makers of JForth 


cwtrmnning or underrmniig aftocattd memory. 


Fred Rsh Disk 233 


options, and sortie other new teanres. Indudes 


Professional 2.0), AJl of tf« material has been 


generation c1 low memory cornbons tor lestng 




source. Aulhor Jus'ii V. McCormick. 


placed into a subdreaory{JGoodies]. Bekiwisa 


purposes, and identjficaton of vTOtabens of 


ten aixJ binary cycfc redundancy cotJes 


Proc EiaTipfe program oJ how jo eeats a tul-SacSged 


listing of subdrectones under JGoodJes ^id their 


memory use by Rename and fin© mmber of the 


iCRCs). TertmodaCRCs caJcu^ied by brik 


DOS process wiihout needing lo cal LoadSeg Erst. 


cons^is, 


a;toca:!ngiou^'na Indtdes source. Author: 


are porlabfe across sysl&ms lor files ihal are in 


Based onanideapnE^senled at BAQGE. Indudes 


Brunjes Various t»l s subm itted together by the author. 


JohnToebesancDct^V/a1ker 


the usual lem format on each syr^em. Binary 


source. Author: Leo Schwab 


StnngPkg is string package tor both Forth style 


RunBack AliowsyoutosiartanewCLtprogramandruirt 


mode CRCs are potabie for files that are 


XprZmodem An Am iga shared bbrary which provkJes 




in te background, then doses the new CLI. Ttvs 


moved from system to system vrttioul any 


ZModem Ele Iransler capabdiv to any XPR- 


handy toots for getting and prirtins (omiatled dale 


is version 6. an update to Sw version on disk 


Change. Bitk can be used to verily and update 


compatible communications program. Version 1 .0, 


ard time . Uils are mil ities used by fw other files. 


1&2 (the version on disk 214 appears to^ be on a 


an embedded checksura header in files. It ruis 


indudes source. Austor: Rick Huetm 


CursorCor,trol is an example of moving the text 


dfterect evduticnary path). ThJs verston 


under MS^tMS, U(ilX system V, BSO UNIX, 


FraJ Rsh Dish 237 


cursor, SpaceOr Escape is a handy word for 


oomples under Lattice with many cptimatior^ 


VAJWMS. and AmgaDOS. This is vwsJan 2.0 


CUPrrl An example of priming to the CU from assembly 


pausing or stoppdid procram ou^uL Endudes 


enabled, and can be made resident Indudes 


and includes EOLK^e-Aidhon RahiiDhea 


cade- iicfudessaioe (of couse}. by: M G^ 


source code. Author Roy ^u^es 


source. Aufwr Rcb Pec^ Dariel Barren, Greg 


CacheCarf AnaccessjfyioSeiCPUfauseDnft 


CType /Jiotheriartlle reader, t*,iaTts one is smaiS, 


Evoiulion TtisprtJSfamgrapfiJealysimLlaiestieevcyionof 


Searto.D3tjgKeeer 


A262) cards or EBOK systems. Jimo*fie*lhe 


reasortaWy fest and hdudes bi-tSrecttoraJ 


a special of tugs', tt» insect kind. Eugs, 


XprtJh External Be kansierprolxdSbiary.Dcx^iiTeTt 


UUU table set up ty SetCPU 10 selectively 


scrolLTg, seardi, go to a given percertage, and 


represensed by moving biobs, eat bacteria 




conirol cachirvg (cf ea* estpansion cart. IT* 


prrding capabittjes. Verbal 1 .0. mdudes source 


represented t^ srngte pixels. They mutate. 


transfer prOKieelS ttSifig Afftlga shfl(*d iSfa'^i 


also an etample of tKrn an aixessory program 


in a^embiy. Author: Bit Ne«son. 


compete lor food . reproduce and pass theic 


Ths is an update to tfie version induded witfi ^ 


can iraA down ane modify me SeiCPU MMU 


Str^R This Ltte program just makes a leitt file ready f» 


mutaijonj to their oflspring, fascinating example 


vlt pro^m on <Ssk 22s, Author: Willy 


table wfthoui haviig to read all Idrris of IMMU 


i;se witi Amiga DOS, wiOi only UneFeed 


of graphics and sonware simiiat^. Standalone 


Lzngevek) 


registers and figure it eyJ for yourself. Veraon 


diaracters (LF) lo mark Ihe end of a Ine. If you 


image and source code. Author: RusseJ Yost 




1 .00. indudes source. Author: Dave Haynie 


feed it a file wJth Of^LY Carriage Fletjm charaders 


FFT Highly optimized Fast Fourisf Transform tools for 


ASDGnd Ejttremely useful shareware recoverable ram 


CitiJsts Complete CRC chet* files lor tfsks 001. £31 


(CR), (from a f^adrtosh lor example) it wilt nepiace 


tfi^tal signal processing. The FFT can be used to 


disk. This AmigaDOS device drhfersmplemerts 


using the brik program also on this disk. TTiese 


tf^OT with the LF character and, if the Tile requiies 


com pute ^ f re(^uency spectrum of a cori plex 


a completely DOS compatible disk device in 


wem made (Srecfly from my masierdste, 1 


no chartges, ihen it does not get ctwigsd, incJLdes 


signal, ft is uselul in a variety of dilferem 


memory (hat survives resets, guru's, a;id 


have swiiehed to brik, irom jrje ere pr ograrr 


source In assembly, by: Bil f#lson 


applications, Fbal^ng pdnt and integer versions. 


crashes. An absolute must for those with tots of 


used to make ihe lists on disks i:u, 146, and 


PkisCR Com panion program fo Str;pCfl , rl reverses the 


Mijfture of high tevd and assembly language coda. 


ram. This is an update to the version releasee 


1 73, because it fias more leaturos and because 


frocedure. PiusCR produces a file ready i» use 


Irefudes source (fequres JForth), Aui-or Jerry 


ondskSS. 11 now works with up to BMb ol 


source is available- Aitfw: Fred Rsh 


on systems whrii reqmre both ^ CR andU 


Kataus 


memory. It was rewriaen tfi assembly and is 


FfBdnihDItkZU 


characters to mark the end ol a tine (such as those 


Guru Handy 'gunj' nunber interpreter [ we;i, handy alter 


now faster and much smailer. B*nary only. 


K wfcBaAUp A hard<fek tackup prograa tr^t writes 


ninring MS-DOS lor eiampie, indudes soiree in 


reboot anyway!). Tells you what "St 000003" 




data sack by track onto multp^e floppy ESsks- 


ass^t^. Author: &lNdson 


means, tor example. CLI us^ or^y. Standatone 


CB3S The WORLl BBS sysiem tor use in amateur 


Uses the an:h(ve brl saves a^ restores 


StripU= Compbiestf«seiofStipCHaftaPlusCR,ltwia 


image wifi readme Ble. Source code induded. 


raAs. O^naSy w:S2En for IBM-PC cwifafttes. 


Dommertts and protection flags, arxJ skips over 


^onge an U only Be ink? a CH only fIeK used in 


AuttK^ MHteHaas 


it was ported to the Amiga by Peie Kara©. Ths 


bad spots during restore. Verson 1.0, irKlydas 


OWiUnalton witfi StripCR arxl PbsCR, it 


H2J Converts 'C'styto'Jvindude Has to JFc^ style 


is VBTsiooe.tc wish soijce code. Author: Hank 


source in Modula-ll. Author: Fridijof Siebed 


comptetes ateit fite oorrversicn system, includes 




iDredson. the CBB3 group. Pete Hartfie 


MuchMore Ajxsther program tike 'mv^\ 'less', •pg", etc 


souroe in assembly, Amhor: &« Nelson 


Amiga libraries fl(«AliP,8lC; Standalone image 


FixCeOtO A program which patctieseiecuiabses that lait to 


Thts one uses its own stjeen to show iha leift 


C LS Clea? Screen Com mand made for the purposes of 


and source code, Au*»r Phi Burk 


run on machines equipped with an Ivl630 10. so 


using a slow scroll, includes built-in hefp. 


being EWALL, and thus not wasteful of memory 


HAMmmm2 Grapfiics hack Ihal tfisplays moving tines in a 


Ihai ihey no fonger use the prohibrted pnv.ledged 


commands lo seardi tctr teil. and commands lo 


whan made memory resident, it ot/isists o( 96 


HAM screen lor a hypnotic effect Uses sound 


mstnxtions. Binary only. Author: Gregor Brandt 


pnnt the text. Wwks with PAL or NISC. in 


b/tesol memory on disk! Indudes source in 


tods trom HMSL. rl avaitaWe. for a drone sound 


Man A ^program similar lo the U MIX "man" program . 


nomas Of overscan modes. Supports 4 cofor 


assembJy. Author: Bill Nelson 


that conespcnds to the graphics image. 


Otspfays fltformation about a loptc from manud 


ten in bold, fta.^c, ursd&riined, or inverse fwts- 


DPiot A^mple display prog ram for e Jtperim ental data, 


Standalone image and source co6&. Aulhor. P^il 


pages. Does not indude any database of topics. 


Verston 1 J, includes source in Moduia-ll and 


vifth the goals d supporting paging through tots of 


Burk 


you have to supply your own. Version 1 2, 


assembfy code, Autxjr Frid^of Siebert 


data and jyovidna comfortable scaling and 


HeadCtean This program, combined with a Bbre deaning 


includes source. Author: Garry Gler^own 


NetWarti Another program in the bnglradftion offscreen 


presentation, Version 1 ,0. source avafeble from 


(f sk, can !» used to dean the heads en your dsk 


MoCfek A program which stences the cBcking of empty 


hacks' for the Amiga, Won! spol the surprise 


aJtfwr.AuttW: AAWaJma 


drives. Sxrcecodoexamptesofacc^5ssingme 


drweswi|heB2D00underAn^E)OSiJ. It 


by saying what rt does. Version 1.0, includes 


iLBMbb Ashared ibrary filbm Jtbra/yj la read^te IFF 


Tradtdiskdevfce. and using gadgets are irduded. 


ShOiAJabow^onanASOO. Thisisverston 


soutoe \n Moduia-tl. Author: Fnd^ Sietsert 


fies, derived Irom itie EA IFF code, along w«h 




3.4, an update to lie version on dsk 231, 


Prtntit A program 10 piirtt IFF picEufes on Epson 


vanousenharcements. hdudes examples ol 


Version ZD.AutfwrPWBirt 


Indudes assem bfy source cxide. Author: 




usng file lorary Ircm C code, assembly code, or 


JustBeeps Simple eiampie of usi.*^ Audio and Tmer 


Norman iscove 


resolutions, witn many ways b tiasnverl color 


BASIC, abng with source for examp^ and 


devices. Plays a series ol beeps wtxjse pilches 


Ties AbasktilegameSksShsngtoiorGiiiShy. A 


pics to yack and wttte Version 1.0, ncbdes 


ffierlace code. Author Jefl Gatl 


are basec on a just intoned tuning sys^m. 


board is covered with a set of m fles. 36 


soutoe in Moduiia-ll. Aiitto: Fridtp! Steben 


ParOU Slows how to allocate and CQfiimunicatt*ectfy 


Standalone image wfth source code. Author: Phil 


different seis of 4 demical ties, each with a 


WBPic Replaces Wori(berKh-s coiorOwth an IFF t^^ 


wlh the paraiel port hardwaie from an aSsemNy 


Bulk 


picture on it. The effect is to r^ove ^1 the Wes, 


norvirttertaoed pidure. in 2 or 4 oo(Qr$. Version 


Esiguage program. InckxJes sowce. Author; Jeff 


htandetbrot A last Mandelbrot rendering program that uses 


2 at a tine, by ma3;;hing kJenical Dies. Version 


1 ,0, incfudes source in Modiilall. Auihor: 


Gatt (originaf C code by Philip Lindsay) 


some of the mathematical prc^jerties c^ ihe 


2.1 , includes source h Modula ll. Aulhon Todd 


FridiiofSiePen 


Speed A pertormar>&9 benchmark useful for comparing 


Manddbrot set to greatly reduce the drawing time. 


Lewis 


XHair Replaces the mouse pointer with a screen wde 


An^ processing speeds. Perlorms lOOOO 


Demonstrates graphics programming, assembly 


fmBihsmm 


crosshair, which is useU lor positioning things 


iteratjoias of some seleded grcups of 6B0O0 


Language, menus and FFfile LO, Standabne 


BootBtocks DataBed documentation on what a bootbtock IS 


vertkaJy or horizonaiy. Version 1 .0. includes 


insirucSons wrtiSe using she DateSlamp time 


image with source code. Author: Nick OicScovsky 


and how it works, atong with some sample 


source in ModLla-li. Author: FrkHjoJ Siebei 


fuiction to recoftl how many bcks it lakes 10 


Neural Net Example of Heurai Met program ming con'/ened 




FrmR3hlMak235 


compli^. This BmedduasonislhOT compared 


to JFoith. Demonstrates a progammihg technique 


txx^^odc tndudes source for the sarcf^ 


CaJcXey A basic four lundor. memory residenL pop-up 


agair^ two known pre^ored lnie$. one for a stodc 


thai many say is the wave of the fcrtife for 


toocblodts and ttie instaif program.. Auflior: 


catajiatar tnhich uses Orty about 24Kof memo^ 


A2000 Am^ and one for an A2620 er^anced 


software. Thfs is a simple demo that stwwsneual 


JonatianPoEer 


and can automabcafy type i^e answer to any 


AacoO. AreJatrvecompariMTiscalciiatedand 


prop^alicn. Standatone image wt:i source code- 


Ct«ck4Mem Aibws you to check for a spedSefi amairt cf 1 


©JcUatiOn into the proyam you were usng , 


displayed Version 1.0, indudes kwco in 


Author FtobenE, La Quey. ported by Jack Woef^ 


memory, vriljcertih aittautos. trom a tnxh Sta. 


when (1 was popped up. VersJonI .0. binary 


assembly language, Auftoc Jei San 


Tejora This easy to-use tejl ed^cr aitows muljple 




oniy. shareware. Aution Craig Rs^ 


FnrffiahPitlLaa 


wtndows, and provides a ^mpie m9.se dnven 


retundftdo is generated. Verston 2, indudes 


Ct An Amiga program to i^y images Inim a CT 


CVVOemo Derno version ol a pop-up utiity to control the color 


interlace. Those famitiarwifJi the 'toanto^ sty^e' 


source. Author Jor^athan Pfflter 


scajTner, abng with sevwa] new inieresting 


register assi^vnents of Intuitiori custom screens. 


ftStors wil be com tortabto witi Textra's Cut, Copy 


CustReq A gtorified ASK coT.ma-^ for yoj startup- 


sample imagK of scans oJreaf people. The 


Version 3.t. binary oily- ^tlw^ Kunbersoft 


and Paste commands. Siandaiore image. 


sequence. Igeneates a requester with the 


dspiay sofhvare. though It has a primitive user 


DMouse A ^«rsaiie screw i mouse blanker, auto window 


tDocumenlation induded. No source code. 


spedfied litfe, text positive and riegative 


interface, is quite powrtui, indutfing tunabns 


activator, mouse accelerator, popdi, pop window 


Author; Iv^teHaa 


gadgets (either of v^ch can be the default), and 


like convolu^ons, averaging, Eaplacians, unsharp 


to from, push window lo bacis. etc, widgel. 


£red,FishDisk24fl 


an optional time<x;t value. Version 2. indudes 


masking, edge deiedion. gradients, etc. This is 


Indudes DLineAn. a screen blanker replacement 


CrossDOS A Ifyware- version ol a mountable MS DOS file 


source. Author: Jonathan Poster 


version 2.2, an update to the version on disk 


program for use with OfAwse. This is DMouse 


system lor the Amiga. This is a sotrwa.'e product 


FitoReq Thi"s is Jotmttwi' s second version of a file 


137. Binary oniy. AcditionaJ image disks 


\trsjon 1 . 20 , an update to versiont . 1 on disk 


ihat allows you to read and wrii,e MSDO&PC- 


requeaer, and is much more powerfuf than ^ 




iesi69, tnckjdessoi/ce.Aut^: ManDilton 


DOS and Atari ST fonnaned disks (Version 2lO or 


one included on disk 204, Shareware, fficbdts 


Hannan 




tiiQhef) direcdy from AmigaOOS. This ^ryware 
version is a "read only" version, which does not 


soufoe. Author: Jcr^athan Potter 



For PDS orders, please use form on page CIII 
Visa and MasterCard is available on orders of $20.00 or more. 
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where can you find all the 

Fred Fish Collection, as well as the Amicus 

Disks and The AC Disks, 

cross referenced and fully listed? 



AC GUIDE Amiga 




AC'S Guide lists the descriptions and 

contents of over 280 

Freely Distributable Software 

disks as well as 

over 2200 Amiga products. 

On Sale Now 
at an your local Amazing Dealer 



FiiWiew Atexi viewer thai uses gasJgetsaiifteDcrLom of 
Sie screa*! (thus can display lgh 80 columns 
wide), opeos up K) 11% liJI fieighi q( l^s worVbcncfi 
screen, tsas i&&. scroBtno, and can mak with 
o&impre$s£Kifilas(MQcompiros&iDn program 
included). Stia/ews^o. bnary ontv, source 
a^a&f^om autcf^ Author. Jonathan Poaer 

imagC'Ed An icon Mitor tnai ailows you to draw and edt 

images up to 150 by DO. in up to 16 colors. Allows 
tceehand drawifig, empty oi liilsd rectangles, 
e^l(@8S> and tnangies. tines curves, a/id pdygors, 
ccpy» ff^ ibom X or y axis. stretchiTig and 
oondensmg, flood A ana oomplomer^, «it with 
«eiectiaT and biti^ of torit iiyle. t^^. magnrf ed 
ifid noonaJ sasa irea^. and rwc actev^ drawing 
sae«maionoe. Thi$»$v«rs»QriLZ. an update to 
vwyon V .9 ori dsk 21 1 , Btnafy onty, sour C9 
ava^at^tt} Irom auinor. Autnor. Jonatnan Pottef 

JAfi A sfwewafE gaine {Jump And Run) using 3-0 

grapTitca. y&j las^ ia la collect tfie blue pills lyhg 
on the [loors ana s^eps, no! 10 (al down or o(f Ihe 
£|eps, ana lo a^id several monster? wandering 
aboc/L You can coiiedvanous sorts d weapons 
tousaagainsuftencmstefs. Version t.O, binaJT 
oriy, botrce avaiable tom author. Author 
Andreas Ehitrtirau: 

JPCkxk AenonclockprogranuiaisjusipactodHdi 

leasures. TNs is ii«r&on til, an upda^ io version 
on(Sska04.lndu!tet$ouco.by: Jonathan Potsr 

PPietS Ptreferabfe Prderencss is a program deigned to 
fspiace She s:iandaJd preti^ences, tiat is shorter^ 
more etScJeniarKl easier St use. Binary oniy. 
Auuior jonauian Poner 

PaletteFteq An easy ^ ay io £«t itio paJctte ol any soeen from 
yoiif program. IndudOS source, by: JonatnanPoner 

Popinb A small Lrtility which •pops open* to give you 

intormation about tne status ol your devioos and 
memory. Ths is version 3.1 , an update lo versbn 
3.0 en tSsk 223. mdufJes source. Atshor: 
JonananPotier 

ZeroVkus A ytymtegraieovrus checker and 16ier,iM^ 
eoatblodisaveanoi«ttorei0aues. Rniteb««h 
bootslQcfi and Oe based vifuseL 'Huisversai 
t A binary only, Auihor. JonatfianPaer 

FftdRlh Disk 243 

F/^it A dynamic memory tnfashcr lor in© Arriga. FragS 
randomly aJtocaies and dsailocaies psuedo- 
random aie value* ol memory, ranging irom 16 
bytes 10 5O0O0 oyi9S oy delauft The result is an 
allocation rJghimare, thousands ol memory 
Iragmenis are being c; eaied and destroyed 
continuously. This puts 2i/ess on the memory 
ajtocaton rousnes of an appliCaUjn undergoing 
testing by simuLaDng a very busy, highly 
liragmented memory onY<rortT.e(l. This is v^^en 
2^. toah^mg mgn]^ lug Fjmm, a kti intuition 
ntortaoe, (xnAguriuon setttfigs via the icon, and 
(oon. rftibdes ntfjos. Author. Ju^ V. 
MeOonMdt 

imageLao A program »hitfi pertomis mage proce$S3ng on 
IFF pictures, hdudes standard image processing 
fusions suoh as wnvoluton. avefaeing, 
smooSuiQ;, enhancoment, hisio^^ams, FFTs, etc 
Also ndbdes file oon version funcbons. a 
oGptioard. and otnor uselui fun^ions. Version 12, 
binary only. Author: Gary Mi Horn 

L?E LaTeX Piciure Editor is a grap^cai editor for 

proouung "piciures* lor the LaToX system, whi:h 
may 00 impofteo Dy LaTeX. You can (Jraw botes. 



dashed boxes, Bnes, vectors, drcies, botes with 
collared text, and p^n teiL T>^s is version i ,0, 
binaiy only. Author: Joefg Geissler 

NoClick A program wNch silences the ciicKing o( empty 
drives on the B20(X} under Am igaDOSi;}. It 
should also work on ar.ASOO. ThisisversioriS.S, 
a last minute update to versiOTi 3 4 on dsk 24i . 
indudes assembly source axle. Aushor: Norman 
kscove 

Passn^drtl A program wtich enhanees yBurooniputDrt 
seomty by maXing it compfiQied enoijgd liat 
i«»3 niffmt yotf password «il get dsoouraged 
lyir0 1» boot and use your iysttm. This tfKxid 
tesp out Riosl »aal or nontac^ncat users. 
Veriion 1 21 p, binary ortly. Auflvx: George 
KcTber 

Poopy An in&Aiion based d^ copier simiiano the 

resident 'DtskCopy". This is versiofi 2,0. a higNy 
upgraded rewrite of the version on disk 151. fl 
teaiufes high speed diskcopy with write-verify and 
data r^xsvery trorn damaged tracks. A bt ol effort 
has gone into making pa% copier Iriendy In is 
usage, as woii m its muititaskng properties. 
Binary on^/. Author. Oirk Reisig 

SimGon This progr am wifl add a 2 or 4 color picture to your 
Woi^<£ertch saeea tf ?ie pioire jS 6git£0d, it 
wi bck mudi ft© a gertocfc, henoa re name 
Sin)Gen(5ini(|a(iedGeniod(). Binary onty. 
Aultur Gregg Tava^K 

Stfiertines A new lines demo with a reaJtime coniroj panel 
that you can use 10 d^ange various aspects ol ±e 
action. Has 1 biifi in eoJof palettes , support foe 
ihinffs Eka ootof 'smudge', cotar cycling, ooior 
"botnco*, muttipb resolutions, and can t£spUy 
oilhur tnes or bo>^:. This isversion 1.0, binary 
only. Author: Chris Bailey 

WarpUtil Warp (versitm 1 . 1 1 ), Un Warp (version 1 jO), and 
WarpSptit ( version t.1). Warp rea<ls raw 
Oaysietrs and ardiv^ tm into a oompresead 
version in a nomiairie. UnWarpiumslheisback 
intoB^ysiems. tlVarpSpGi ^jlits them if) irtb 
smafier pieces on a tiack by ttsdcbdsis. Binary 
only. At*<ir:SDS Software 

Fr«lRih&ak2U 

BBChampion ThisisBootaockCnampicnnt.av&'ynicaly 
dora pr^am ihal aJ'cms yo^j to k^, save, and 
anajyie arty bootblock. This is version 3.1 , bnary 
only. Author, floger Fschlin 

Bootintro This program creates a an aStfr/o on ihe 

bootblock of any disk, which will appear after you 
insert the sS^ for booi^ng. The headline cart be 
up ID 44 Characters. The scroiDng text portion can 
bo up 10 30O charsci^s. Ths is version 1 2. an 
update to rasion 1 jO on dislt 1^. Bitery only. 
Author: Rogty Rscrtr, 

FMC An ail&Tiative to !he^toFa£t1uVem program. Uses 
a ouie Imie switch gad^ to tuTi last menxyy on 
orctt. Version 12, includes souMin assembly 
oode-Auynor Roger TtschCn 

SizeChedear Saa checker uses a list d pos&bSe sizes d a 
He to check k)t unexpected :hangas in the siie of 
those Ses, For example, it can be used to spot a 
link viAJS Of 10 fom out eftanges in flie 
cofiBguraijon of your system. With tie appropfiatja 
comments added lo your size list, you can check 
to see what version of tfie iiies you are using (1.2, 
1.3. 1.4. ARP, etc). Verier, 1.0, bmaiy only. 
Autha. Roger Fischl in 



TextDisplay A text display program, ike "mare" or less', but 
about h^E the size and handles alt sa<een formats 
(pal ntsc,interlawi'non interlace, etc). This is 
version 1.52. an update to version 1 .1 on disk 
isa. Binary only. Auihor: Roger FiSChSn 

XCofer Apro^Ti designed to Ctiange the colors of any 
screea You can also add and subtract bitplanes 
in the screen. Of convert the screen 10 Slack and 
whife (grayscale). Hanjfes HA.M and EHB 
saeens. Version izindudes source in 
assanbily code. Autior floger Rschin 

FrtdRsh Disk 245 

ATOf Asmalutttythatalowsyoutoifsethetonisc^ 
ajioCier disk without using the CU. Version i .0, 
birBjyoriy. Author: Roger FiKWin 

Bortkitro Thtspnogamcreatesasmansnlroonlie 

bootblock of any disk, which wil appear after you 
insert the disk for boofing. This is Ihe "next 
generalori* Bootintro, a moro Cotorlul versfon than 
the one on disk 244, but the lent must be shorter. 
Thofirsilnocanbeupto24diaraders, ThQ 
second and third hncs can be up to 22 characters. 
The scroll text can be up 10 98 characters, This 
is "Tiext generation version 1.1'. Binary only. 
Ai,ir»r. Roger nscntn 

Ferrer A progriTi iwhiiih can operate on winders owried 
bf anostief prog-'am, so ck^ thKn, change their 
size; rstish gadgett, move fie wndo* to iw 
backgrounlilc. Version 1.0, inckxtessouca 
Mhoc. RogefBscMn 

PathMasler A Re requester wtih bts of (eaiires. Can 
be easdy configured by the programmer to sUt a 
variety olappiications. Includes source. Airthor: 
Justin Mccormick 

ReversI Rays the classical rover si game on an 8 x B 
square field. Version i Z includes source in 
assembly code. Airiior: MarcFischRn 

VJt This is a binary upda'p te the vlt program on dek 

22€, and fixes a pr obJem with external protocol 
support. You siiil need the rest ol the fles from 
disk 22S. Ver5ion4J}6S, l^nary or^y. Ajlhon Wily 
i^angeveid 

FftJRafiM3hi« 

Dr^ake Rdease version 1.0 oUtoffsvwsiqnoltieUNiX 
makeytiity. Update lob^veoion reused on 
iik 1 79. Features rniiiple dependancieSv widcanj 
sjjppoa, and more. Hrary orty. AjJhcr: MaH 
Dikn 

LabdPrim Aprogram Chat alows you to easily prir^labds for 
your disks. This is version 2.£b. an update to 
version a 5 from disk £38, Shareware, binary only 
(source avaitabfo from author). Author Andreas 
Krebs 

NComm A terminal piogram lor the Amiga based on comm 
version 1 .34. Has hot keys for mosi program 
fundions (including dialing up to ID phone 
runbers}, PAL and NT SC syppcrt for normal or 
iiteriaced soreerts, screen 10 greater than 2400 
(stud, A^S1VT1 00 tem-.inaJ em Ltaion with f u! 8 
color tG3t support lau graphics, optknal 
l^anslaioi e^. tpft stSBBh mode, f J L^ 
oonlrd ol color palritB; fiji support for all European 
languages. Ml serial port oonfrd wrih baud rates 
up to 1 920Q. script language, phonebook, 
keyboarc r;iatJOS, and moro Version is, binary 
eti>f, Autnor; IXI James, Oaniei Btoch. et. al 

NoCSck A program which s-lences She cfcking d empty 
drives on the BEOOO under AmigaCX)S 1 3. !l 
shouM also work on an A500, This is veisiwi 3£, 
an' update to version to version 3.5 on dsk 243. 
Includes assemby source code Authsr Norman 
Isoove 

ScreenShare A kbra,^ ar^d support programs that enable 
appl-caSons lo open up windows on otts 
appl-calions' custom screens. For exampte, your 
odtor m ay w^r^ to, open a wirdow on your termkal 
err.iiaJa's saeen so you can compose a message 
while stli being abSe to sec tie cortem of the 
terniinafs screen. BothappkatJorsnust 
cooperate for the screen shafjig to work. Version 
1 .2, irdubes source for Interface portions, Atrthoc 
WI^Largev^W 

Ty A text display program based on Aiiiga less' 

version i.o. Has both keyboard and rr.ouse corttrol 
of al furctons. an intuition intefface. and uses the 
Amiga specific keys (such as the Help key) 
oorrectly. Version l ,3, tKludes source. Author; 
Mark Nudotman, Gob Leivian. Tcny Wills 

FfttiF!5*lPlSK247 

AnaJogioys^ Software support lor use of analog joysticks 
cr- t>e A-niga, ind jdes a dfiver , a heada^ &le tor 
code tt-iSt cails the driver, and an example frogram 
thai uses she diiver. hdudes saifce. kJtiar. 
03veKin2ar 

A^emToots A coUedion ol lies wtidi should be of 
great Bitsr»t to Amiga Biumbly language 
prognmnerL Thaoofledoninchide»l4€mac3io 
roufnw wtiich rnake aswmUy language 
pfogartming a to( easier, ThereisasoaSbraryof 
routines cofUaining buffered C-ftke liie hancSng 
funcwns (ft^ien. Ickise, fgets, fputs, eicj and a He 
name requester. An rotrtines are re-entrant. 
Includes source for example programs using the 
macros ard library, and a &5cD2 cross macro 
assembler, Airthor ; JuWa Marin 

RemcMx^n A ooi^ ol programs wiich rriake possible 
remote access to your Ar.iga. iDne program 
cheeks the serial pon tor an mccming can, and 
starts a program when n is detected. The other is a 
passMQfd prtttdion prograiri wtvch atkws starting 
various pcograms based upon login id, thus 
providng some minimal secwity for you- compLtef. 
IndsJdes source. Au*icr DaveKjnjEr 

Xpriib External Re tansfer pfctecd library, Doorrer* 
and code example lor implcmerting external &1e 
transfer protocols using Amiga shajed librariK. 
TWs is version 2.0. an update to the version on 
disk 240, wth many extensions and 
enhancements, tocludos sample XPft library and 
source. Author' V/iUy Langeve^d 



Ffe.deah.Diih 246 

AmiGann A project deSnitionandmanagementtod designed 
10 crease a simple, interactive method ol outlinifig 
the task requtred to complete a panjcutar pro^ct, 
usfng the G AMTT :h£rt as the Lipyt fonnaL 
Am'iGantt displays the project in a multi-window 
mode with separa*^ windows for the G ANn chari 
task inlormation irpul, resource histogram cJ splay, 
and Pert chan dsptay. Up to 500 tasks may be 
defined tor any prefect, ard a project may contain 
other prqeas as tasks. Version io.O, shareware, 
binary orty. Author: Donald Toteon 

C Li-Colars A Sim pie little program to change tfw ootore of t» 
border around a CU window, inchidM sotfca in 
assartbJy code. AjUior Michael Sim 

Flpper A small, last, CtheSoprogam. Does not use any 
took-ahead methods. Binary onfy.Auihcr Miohaei 
Sinz 

Maze An example of a tuiiy re-entrant m aie generation 

program written in assembly language using Manx's 
assembler. Indodes source. Author: Wichaei Sim 

KelHander The Software Distillery s network fie system 
harKlfef (NET:), using Matt Dftonfs ONET to mount 
one Amiga's devit^ort another Am^ a. It also 
serves as an example 6te system wriaen entirely in 
Lasijoe C, Version i a, includes sour;^. Autior: 
SoftwaieDistiJery 

Regex An Amiga shared £bra.7 version of the GNU regular 
exptes&bn patk^ bom the Fr^ Software 
Fouidalon. A regplaf ex^^ession is a concise 
method of deserting a panem o( tfiaraciers ir a 
stnng. By use ol ^^edal wildcards, atmcet any 
partem can be desaibetJ. A regular expression 
pattern can be used isr searching sSnngs t\ such 
programs as edittxs or other sB'ing handling 
programs. Version 1.0, includes Source. Aulha: 
Edwin Hoogertieets, FSF, .im Mackraz 

Fred Rsh Disk 249 

Autom aia Fou ceSuiar automata program s . AutomaTrcn is a 
one dimensicra! cellular automaton, Crud is a 
autom anon basec on a sum index rule. Demon o a 
cyck space autorr^ton descnbed in itie Aug Big 
ScJentific Ai^erican. and Life is one of the odest 
and best ttnown cf an ceiUar automata. Includes 
soufoe. Auftor Gary Teachoui 

Sicer Sficer computes and tisplays images ol the 

Mandelbrot and JJa sets. Udke many MandeUxoi 
programs ihal genersts pictures tSrecSy, Steer 
computes and stcres an anay of raw data which ri 
may then render ito pictures in a number ol ways. 
Version 1 ,0, binary only. Author Gary Teachoui 

TurMne AtwodimEnsionaltufingmachlnesimulator, 
Imagine a small tug ciawling around on your 
computer tisplay moving one pinel at a time. Al 
each step it uses rts internal state number and the 
color d the pixel it's on as indexes into a set o( 
tables to decide what cokx to c^ange itie piief to, 
what ttrecton to move, and what its new iraemal 
Stale should be. indudes souce. Auihor: Ga7 
Teachout 

FffftiFJsnpiikSO 

ASirtiplex An implemeniatcnorths Simplex algontfjTi tor 
BOfviftjlfTear programs, tt uses the standardiiad 
MPSX-iormat tor input data fJes. This is vers<on 
1,5, an update to version 1 .2 en cSsk 1^. Changes 
indude txjg Sxes, the abiity to run from CLI, its owr 
window tar it), and some new and improved 
oommands, Indodes source. Author: Stefan 
Fofster 

Gravity-Well A oetestial motion smdalor that simulates 
the motion ol up to hventy bodies in a Newmnan 
universe. The view el the simu^tion may be scaled 
mtsled in tihree dbnensions or repositioned. 
Ifidudes soute, Autior Gary Teachout 

Paranoids An asylum escape game. Paranoids is a tradibonal 
board game piayed by drawrig cails. roPirq tSce, 
and moving pieoes around the board. Each player 
has six poces. SOU' ;»|jen!s and two doctors. The 
dbjeci of tie g^Te is to get al ol yotx patients out 
the asyhjn. This is version 1 .0. b'nary only. Author: 
RidTard Andefson and Ga-7 Teachous 

RPSC A reverse polish sder^tific cataJatot. R PSC is a 
proyammaWe R?*N calcuilaaor in the Hewlett- 
Packard tradtion. It supports operaicfiswtih real 
msnbers, compfex nunbers, matrKes, and 3-0 
vectors, as wefl as storage and recall of labeled 
variables. Data and programs may be saved, 
loaded, or written as ASCI! text, to Amiga(X)S files. 
Ths is version t,i, binary only. Author: Gary 
Teachout 

ToBeConSiiyed 

In Conchision 
To fte besi of 0(j knowfedge. tve materials in the ibrary are 
(reelydteitajtabie. This means they were eimerpubfidy 
polled and placed in the pusCc domain by «vif authors, or 

they have restrictions pu«t^>ed in their fifes to wtiich we fiave 
adored , If you become a ware ol ariy violation d tie au-hors' 
wishes, please comact us by ma3 

IMPORTANT NOTICEl 

Ths list is compiled and pubfshed as a service to the 
Commodore Amiga oommunty lor informational purpose; ofi^^. 
Its use is restrJcied 10 noncommercial groups only I Any dqpt- 
cation tor oomm&tialpuposes is sirictfy forbidden. Asapartol 
Amadng Computing™, tw list is inherefitly copyrighted Any 
mlringemenl on tiA propnetary oopyiight wihoul etpressad 
writ%n perm ^«ton ol the pubfishers wfl incur the ton force of 
egaiacsor^. 

Any rcn-cofT^mercial Amiga user grcqa wishrr^ to duplica*^ 
this list shodd contact: 

PM FubficatJons, Inc. 

P.O,Box869 

Fall River, MA 02722 

PiM PuWicalions Inc. is eriremelV interested in helping any 
Amiga vs^ groups in non-commercial support for the Amiga. 
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A Winning Hand with an Ace in the Whole! 

Amazing on Disk 

Source Listings and Executables from the pages of Amazing Computing! 
Only $6.00 per disk ($7.00 for Non-Subscribers) 





AC#1 



V3.8 & V3.9 



AC Disk #1: source and executable code: AC y5.S 

& AC V3,9. 

Gels In MultiForth Parts I & 11: Leam ho%v to use 

Gels in MultiForth. Author: John Bushakra 

FFP & IEEE: An Example of using FFP & IEEE math 

routines in Mcxluhi-2. Author: Steve Faiwiszewski 

CAJ: A complete Computer Aided Instruction program with editor written in 

Amiga BASIC. Author: Paul Castoriguay 

Tumblin' TotS: A complete game written in Assembly language. Save the falling 

babies in this game. Author: Davd .'Ashley 

VGad: A gadget editor that allows you to easily create gadgets. The program then 

generates C code that you can use in your own programs. Author: Stephen 

Venneulen 

MenuEd: A menu editor that allows you to easily create menus. The program then 

generates C code, that you can use in your own programs. Author David Pehrson 

Bspfead: A powerful spread shcct.program written in Amiga BASIC. Author Brian 

Cately 



AC Disk #2: source and executable code for AC V4.3 and AC V4.4. 

Fractals Part I: An introduction to the basics of fractals with examples in 

AmigaBASlC, True BASIC, and C. Author; Paul Casionguay 

Shared libraries: C source and executable code that 
shows the use of shared libraries. Author: John Baez 
MultiSort: Sorting and intertask communication in 
Modula-2. Author: Steve Faiwiszewski 
Double Playfieid; Shows how to use dual playfields in 
Amiga BASIC. Author: Robert D'Asto 
'881 Math Part I: Programming the 68881 math 
coprocessor chip in C Author: Read Pre dm ore 

Args: Passing aiguments to an Amiga BASIC program from the CLL Author: Bnan 

Zupkc 



AC #4 



V4.7 & 4.8 



Kemp 



Better String Gadgets: How to tap the power of string 
gadgets in C. Author: John Bushakra 
On Your Alert: Using the system's alerts from 
.AmigaBASIC. Author: John F. Wiederhim 
Batch Files: Executing batch files from AmigaBASlC. 
Author: Mark Aydellotte 
Notes; Tlie beginning of a utility program in C. Author: Steven Kemp 



AC #2 



V4.4 



AC #5 



V4.9 



AC Disk #3: source and executable code for AC V4.5 and AC V4.6 

Digitized Sound: Using the Audio-device to play digitized sounds in Modula-2, 

Author: Len A. White 

*8S1 Math Part JL Part II of programming the 68881 math coprocessor chip using a 

fractal sample. Author: Read Predmore 

At Your Request: Using the system -sup plied requestor from AmigaBASlC, Author: 

John F, Weiderhim 

Insta. Sound: Tapping the Amiga's sound from 

AmigaBASlC using the Wave command. Author: Greg 

Siringfellow 

MIDI Out: A MIDI program that you can expand upon. 

Written in C. Author: Br. Seraphim Winslow 

Diskless Compiler: Setting up a compiler environment 

that doesn't need floppies. Author Chuck Kaudonis 



AC #3 

V4.5 & y4.6 



AC Disk #4 source and executable code for AC V4.7 and AC V4S. 

Fractals Part Et: Pan II on fractals and graphics on tlie Amiga in AmigaBASlC and 

True BASIC. Author: Paul Castonguay 

Analog Joysticks; The code for using analog joysticks on the Amiga. Written in C. 

Author: David Kinzer 

C Notes: A small program to search a file for a specific string in C. Author; Steven 



AC Oisk #5; source and executable code for AC V4.9. 

Memory Squares: Test your memor>^ with this AmigaBASlC game. Author: Mike 

Morrison 

High Octane Colors: Use dithering in AmigaBASlC to get the appearance of many 

more colors. Audior: Robert D'Asto 

Cell Animation: Using cell animation in Modula-2. Author: Nicholas Cirasella 

Improving Graptiics: Improve the way your program looks no matter what screen it 

opens on. In C. Authro: Richard Martin 

Gels in Multi-Forth-Part 3; The third and final pan on using Gels in Forth. Authon 

John Bushakra 

C Notes 4.9: Look at a simple utility program in C. Author: Steven Kemp 

3lD_Cells: A program that simulates a one-dimensional cellular automata. 
AuthonRussell Wallace 

Colourscopc: A shareware prognxm that shows 
different graphic designs. Author: Russell Wallace 
ShowILBM; A program that displays lo-res, hi-res, 
interlace and UAM IFF piaures, Autlior; Russell 
Wallace 

Labyrioth„II: Roll playing text adventure game. 
Author; Russell Wallace 
Most: Text file reader that will display one or more 

files. Tlic program will automatically format the text for you. Author; Russell Wallace 

Terminator: A virus protection program. Author: Russell Wallace 

AC Disk #6; source and executable code for AC V4.10 & AC V4.ll 

Typing Tutor: A program written in .\miga BASIC that will help you improvr your 

typing. Author: Mike Morrison 

Glat's Gadgets: Using gadgets in Assembly language. Author: Geff Glatt 

Function Evaluator: A program that accepts mathamacical fiincdons and evaluates 

them. Written in C. Author: Randy Finch 

Fractals: Part IH: AmigaBASlC code that shows you 

how to save/load pictures to disk. Author; Paul 

A /^ // >^ L Castonguay 

IX I TT^O I ^^^ Requestors: Using system calls in AmigaBASlC to 

^ "^^^ ^^ I build requestors. Author: John Wicderhirn 

V4.10 & V4.ll I Multi-Forth: Implementing tlie ARP library from Forth. 
^^^^^H^^^H^^J Audior: Lonnic A. Watson 

Search Utility: A file search utility written in C, Audion 
Steven Kemp 

Fast Pics: Re- writing the pb:el drawing routine in assembly language for speed: 
Author: Scott Steinman 

64 Colors; Using extra-half-brite mode m AmigaBASlC. Authon Bryan Catley 
Fast Fractals; A fast fraaal program written in C with assembly language subrou- 
tines. Authon Hugo M.H.Lyppens 

Multitasking in Fortran: All the hard work is done here so you can multitask in 
Fortran, Authon Jim Locker 
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Two Great New Ways to SAVE 
on the Original Amiga Monthly Resource 



Name 

Address , 
City 



Complete Today, or Telephone 1-800345-3360 



State 



_Zip_ 



Charge my DVisa DMC #_ 
Expiration Date 



. Signature _ 



p ^ ^ 


[MasterCard] 


L ^ J 



VISA 



Please circle if this is a New Subscription or a Renewal 

PROPER ADDRESS REQUfREO. \t\ order to expedrte and guafantee your order, all large PubSc Domain Software orders, as wefl as most Back 
issue orders, are shipped by United Parcel Service. UPS reqtjsres that all packages be addressed to a street address for correct delivery. 



.*Vll Charges are subject to a S20.00 
mmimum (charges under 520.00 
will receive a $2.00 sen'ice charge). 



One Year 

Of 

Amamig! 


Our regular renewal now includes 12 montlily issues of -. D 
Amazing Computing plus the Spring edition of AC GUIDE^MIGA Q 

n 


S28.00 U.S 

S 14.00 Foreign Surface 

S36.no Omada and Mexico 


Our 

New 
SuperSub! 


12 monthly issues of Amazing Computing PLUS AC GVlDE^tMIGA D 

3 Product Guides! Spring, Fall, and Winter! A savings of $32.25 off the Q 
new^sstand price. The Product Guides alone retail for $6.95 each D 


S36.00 L\S 

S52.00 Foreign Surface 

S i i.OO Qinada and Mexico 



Please circle any additional choices below: 



(Domestic and Foreign air mail rates available on request} 



Back Issues: 


$5.00 each US, $6.00 each Canada and Mexico, $7.00 each Foreig 


n Surface. 


V0I1.1 V0I1.2 


V0I1.3 


V0II.4 


V0II.5 


Vol 1.6 Vol 1.7 




Voi1.8 


Vo!l.9 


V 


0I2.1 




V0I2.2 


V0I2.3 Vol2,4 


V0I2.5 


V0I2.6 


V0I2.7 


Vo!2.8 Vol2.g 




V0I2.IO 


V0l2.11 


V0I2.IJ 


) 


V0I3.I 


V0I3.2 V0I3.3 


W3A 


V0I3.5 


V0I3.6 


V0I37 V0I3.S 




Vo!3.9 


V0I3.IO 


Vol3.r 




V0I3.I2 


Vot4.1 Vol4,2 


V014.3 


V0I4.4 


V0I4.5 


V0I4.6 V0I4.7 




Voi4.8 


V0I4.9 


Vol4.1( 


) 




Public Domain Software: 




























$6.00 each for subscribers (yes 


, even the new ones!) 












$7.00 each for non subscribers 




(three disk minimum on all foreign orders) 


Please circle your Public Domain Software choices below: 
















Amazing on Disk: Aff 1 . . .Source S Listings 


yZM V3.9 




A#2.. 


Source & Listings 


V4.4 












A#3. . .Source & Listings 


V4.S a V4,G 




A#4. . 


Source & Listings V4.7 & V4. 


B 










A#5- - -Source & Listings 


V4.9 






A#6. . 


Source & Listings V4.10 & V4.1 1 












] 


InNOCKulation Disk; INfl... Virus protection 












AMICUS I, I, 


3 

22 


4 
23 


5 
24 


6 
25 


7 
26 


8 9 10 


11 


12 13 


14 15 


16 


17 


18 


19 


Fred 


1 2 


3 


4 


5 


6 


7 


8 9 10 


11 


12 13 


14 15 


16 


17 


18 


19 


20 21 


22 


23 


24 


25 


26 


27 23 29 


30 


31 32 


33 34 


35 


36 


37 


38 


Fish 


39 40 


41 


42 


43 


44 


45 


46 47 48 


49 


50 51 


52 53 


54 


55 


56 


NA ' 


58 59 


60 


61 


62 


63 


64 


65 66 67 


68 


69 70 


71 72 


73 


74 


75 


76 


Disks 


77 78 


79 


NA 


81 


82 


83 


84 85 86 


87 


NA 89 


90 91 


92 


93 


94 


95 


96 97 


98 


99 


100 


101 


102 


103 104 105 


106 


107 108 


109 110 


111 


112 


113 


114 




115 116 


117 


118 


119 


120 


121 


122 123 124 


125 


126 127 


128 129 


130 


131 


132 


133 




134 135 


136 


137 


138 


139 


140 


141 142 143 


144 


145 146 


147 148 


149 


150 


151 


152 




153 154 


155 


156 


157 


158 


159 


160 161 162 


163 


164 165 


166 167 


168 


169 


170 


171 




172 173 


174 


175 


176 


177 


178 


179 180 181 


182 


183 184 


185 185 


187 


188 


189 


190 




191 192 


193 


194 


195 


196 


197 


198 199 200 


201 


202 203 


204 205 


206 


207 


208 


209 




210 211 


212 


213 


214 


215 


216 


217 218 219 


220 


221 222 


223 224 


225 


226 


227 


228 




229 230 


231 


232 


233 


234 235 


236 237 238 


239 


240 241 


242 243 


244 


245 


246 


247 




248 249 


250 






(NA Denotes disks removed from the collection) 











Subscription: $__ 



Back Issues: $_ 



PDS Disks: $_ 



Total: 



Please complete this form and mail with check, money order or credit card information to: 

PIM Publications Jnc. 

P.O. Box 869 

Fall River, MA 02722-0869 



Please allow 4 to 6 weeks for delivery 



Finally. An on-line service 
that doesn't nickel and dime you. 



It's BIX's flat-fee service. 

BIX is short for BYTE Information 

Exchange. The on-line informa- 
tion senice that's yours for an 
unheard-of flat fee of just S39 for 
three months'— an amount you 
could easily waste in just two to 
four hours with an hourly rate, 
on-Une service. (Not to mention 
the fact that you'd be nickel-and* 
dimed for its monthly minimums.) 

And BIX is strictly for pros; it 
contains no "fluff." As a sub- 
scriber, here's what you've got 
coming to you: 
D Amiga Exchange— ]mn the 
thousands of Amiga developers 
and enthusiasts in conferences 
covering software development, 
using Amiga's libraries, hardware 
development, artistry tools, and 
Commodore's developer 



support conference. 

n Mkwbytes DriIv — up-to-the- 
minute industry news and new 
product information. 

n Plus access to extensive software 
libraries, and the use of our 
electronic mail service— which 
allows binary attachments. 

Subscribe to BIX right now — 
using your computer and modem 
Set your telecommunications 
program for full duplex, 8 bits, no 
parity, 1 stop bit, or 7 bits, even 
parity, 1 stop bit. Now dial BIX at 
617-861-9767, hit the return key, 
and respond as follows: 



Prompt: 

login (enter"bix"): 
Name? 



You can charge your BIX 
subscription to major credit cards. 
or have it billed to your company. 
You may also buy unlimited off- 
peak access via T\TOnet for just 
S20 per month, or S3 per off-peak 



^^- 



/^.:- -: 










V'.>- 







^:i'rw 



Variable Dither - 

Computed internally at 
30 bits per pixel (over 
one billion colors). Gives 
you over 100,000 appar 
ent colors on screen. 



Sophisticated. 



Flexible Text Rendering - 

Allows for anti-aliased — 
fonts, Rainbow Fonts and 
Transparent Fonts and 
more. 



Revolutionary. 



User-Controllable 
Transparency - Allows 
real time control of the 
amount of transparency 
and the location of the 
light source. 



Unlimited. 



Unmatched- 





Super BitMaps with 
Auto-Scrollrng - Real- 
time scrolling on up to 
1024 pixels high or wide 
image with full overscan 
display. 



Flexible. 



Colorize - Play Ted 
Turner and add color to 
black-and-white images 
or change colors on 
already colored images. 



Powerful. 



Texture Mapping with 
Anti-Aliasing - Gives you 
super-fast warping and 
stretching of any image. 



Intuitive. 



Transfer 24 - Digi-Paint 3 
comes with Transfer 24 
image processing soft- 
ware to give you support 
of all Amiga resolution 
modes and the same 
advanced image proces- 
sing found with NewTek's 
best-selling Digi-View 
Gold Video Digitizer. 



100% Assembly 
Language - Makes DIgi- 
Paint 3 the fastest HAM 
paint program ever! 



w 




The Ultimate Paint Program: 



DICI*PAINT(3 



For more information call NewTek at 800-843-8934 or 913-354-1146 

Oigi-Paint 3, Digi-View Gold and Transfer 24 are trademarks of NewTek Inc. 
Circle 1Q2 on Reader Service cfird. 



NewTsK 

INCORPORATED 



